Skip to content

Importing from EVE-NG / UNetLab / PNETLab

This section walks an operator through migrating an existing EVE-NG (or UNetLab / PNETLab) host's images and templates to a fresh nova-ve install.

The end state: every supported addon directory under /opt/unetlab/addons/... is materialised under /var/lib/nova-ve/images/<kind>/<key>/, every priority-vendor template is converted to a nova-ve template under /var/lib/nova-ve/templates/, and the operator can instantiate nodes from each migrated template through the nova-ve UI.

The importer ships as a venv'd Python module (backend/scripts/import_eveng) and a root-asserter shell wrapper at deploy/scripts/import-eveng-templates.sh.

Pages in this section

  • Overview — flags table, prerequisites, and run order (--dry-run → real → optional --delete-source).
  • Importing images — per-kind source → destination mapping for qemu / dynamips / iol / docker, plus boot-disk precedence and verification recipes.
  • Vendor coverage — which vendor adapters can emit a nova-ve template natively.
  • Reading the manifest — the manifest JSON shape, handling needs-manual-review, and rollback.

Non-destructive by default

Running import-eveng-templates.sh with no flags is non-destructive. Sources under /opt/unetlab/addons/... are copied + sha256-verified at the destination; the source files are left untouched unless you pass --delete-source (or the unsafe --move).