EVE-NG V6 → V7 Upgrade Process

This guide describes how to upgrade an existing EVE-NG V6 server (Ubuntu 22.04 LTS) to EVE-NG V7 (Ubuntu 24.04 LTS) using the EVE-NG 7 Upgrade Assistant.

The upgrade package is a single self-contained file that embeds the full V7 ISO and performs the migration automatically.

Overview

Item	Detail
Source	EVE-NG V6 (Ubuntu 22.04 Jammy)
Target	EVE-NG V7 (Ubuntu 24.04 Noble)
Upgrade package	`eve-pro-prod-bm-7.0.1-1-full-upgrade.run`
Supported roles	EVE-NG Pro Master and Satellite
Duration	Typically 10–30 minutes (hardware and lab size dependent)

Before You Start

Requirements

Root access to the EVE-NG server
At least 40 GB of free disk space
All EVE-NG lab nodes stopped
A full backup of labs, configurations, and database strongly recommended

Important recommendations

Stop all running nodes before starting the upgrade.
Back up your EVE-NG server (labs, configs, database).
If connected over SSH, run the upgrade inside screen or tmux to avoid interruption if your session drops.
On Satellite nodes, ensure no wrapper processes are still running. Stop all nodes from the Master first, or reboot the Satellite before upgrading.
The upgrade migrates the underlying OS from Ubuntu 22.04 to 24.04 LTS. Third-party APT repositories may be temporarily disabled during the process.

Step 1 — Download the upgrade package

Download the upgrade file to your EVE-NG server:

eve-pro-prod-bm-7.0.1-1-full-upgrade.run

Example:

cd /root

wget https://customers.eve-ng.net/eve-pro-prod-bm-7.0.1-1-full.iso/eve-pro-prod-bm-7.0.1-1-full-upgrade.run

(Replace the URL with the official download link provided on the EVE-NG website.)

Step 2 — Make the package executable

chmod +x eve-pro-prod-bm-7.0.1-1-full-upgrade.run

Step 3 — Start a persistent session (SSH users)

If you are connected via SSH, start screen first:

screen -S eve-upgrade

Step 4 — Run the Upgrade Assistant

Run the package as root:

./eve-pro-prod-bm-7.0.1-1-full-upgrade.run

Step 5 — Follow the on-screen prompts

The EVE-NG 7 Upgrade Assistant will:

Display the support disclaimer — type yes to continue
Confirm the full migration to Ubuntu 24.04
Stop background upgrade services
Mount the embedded V7 ISO
Perform the OS and EVE-NG package upgrade
Reinstall EVE-NG Pro or Agent packages
Refresh bundled Docker images (Master nodes)
Configure Ubuntu 24.04 and EVE-NG APT repositories
Update GRUB and initramfs

You may be asked to confirm additional steps, including Docker container removal if containers are still present on the system.

Step 6 — Reboot

After the upgrade completes successfully, reboot the server:

reboot

Then verify:

EVE-NG web UI is accessible
License status is correct
Labs open correctly
Nodes start as expected

Logs and troubleshooting

Upgrade logs are stored under:

/var/log/eve-upgrade-universal-<date>_<time>.log

APT configuration backup (if created):

/root/.eve-upgrade-backup-<date>_<time>/

If the upgrade is interrupted over SSH without screen/tmux, reconnect and check the log file before retrying.

Optional flags

Flag	Purpose
`--yes`	Non-interactive mode (auto-accept confirmations)
`--force-direct`	Allow direct SSH execution without screen/tmux (not recommended)

Example:

./eve-pro-prod-bm-7.0.1-1-full-upgrade.run –yes

Quick reference

cd /root

wget <official-url>/eve-pro-prod-bm-7.0.1-1-full-upgrade.run

chmod +x eve-pro-prod-bm-7.0.1-1-full-upgrade.run

screen -S eve-upgrade

./eve-pro-prod-bm-7.0.1-1-full-upgrade.run

# type: yes

reboot

Summary

Upgrading from V6 to V7 is a major platform migration (Ubuntu 22.04 → 24.04). The eve-pro-prod-bm-7.0.1-1-full-upgrade.run package automates this process. Plan for downtime, back up your environment, stop all nodes, and run the upgrade from a stable root session