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
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.
Safe Upgrade Recommendations
Option 1 — EVE-NG Backup Manager
- Use the built-in Backup Manager to back up the database, labs, and temporary folders.
Option 2 — VM Snapshot
- if EVE-NG runs as a virtual machine, take a snapshot before starting the upgrade.
- Keep the snapshot until the system has been fully verified on EVE-NG V7, then consolidate/remove it once everything is confirmed working.
Cluster upgrade order
If your EVE-NG environment is using a Master / Satellite cluster, upgrade the full cluster during the same maintenance window.
The recommended order is:
- Stop all running labs and nodes from the Master.
- Upgrade all Satellite servers first.
- Reboot each Satellite after the upgrade.
- Upgrade the Master server last.
- Reboot the Master.
- Verify that all Satellites reconnect correctly to the Master.
Do not run production labs on a mixed V6/V7 cluster. The Master and all Satellites should be upgraded to the same EVE-NG V7 version before normal usage resumes.
On Satellite nodes, ensure no wrapper processes are still running before starting the upgrade. Stop all nodes from the Master first, or reboot the Satellite before upgrading.
Step 1 — Download the upgrade package
Download the upgrade file to your EVE-NG server:
eve-pro-prod-bm-7.0.1-21-full-upgrade.run
Example:
(Replace the URL with the official download link provided on the EVE-NG website.)
Step 2 — Make the package executable
Step 3 — Start a persistent session (SSH users)
If you are connected via SSH, start screen first:
Step 4 — Run the Upgrade Assistant
Run the package as root:
Step 5 — Follow the on-screen prompts
The EVE-NG 7 Upgrade Assistant will:
- Display the support disclaimer — type
yesto 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:
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:
APT configuration backup (if created):
If the upgrade is interrupted over SSH without screen/tmux, reconnect and check the log file before retrying.
Optional flags
Example:
Quick reference
Summary
Upgrading from V6 to V7 is a major platform migration (Ubuntu 22.04 → 24.04). The eve-pro-prod-bm-7.0.1-21-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