EVA Deployer is an Ansible-based tool for installing and deploying EVA across different network and infrastructure environments. On Ubuntu 24.04, it automatically installs and configures EVA App, Agent, and Vision together with k3s, GPU/MIG, Harbor, NFS CSI, n8n, and related components.

EVA Deployer Github

https://github.com/SpectraBrain/eva-deployer

Repository Modes

Three modes are supported depending on the installation environment.

• cloud_repository: The target server can directly access the internet, ECR, and S3.
• remote_repository: The target server has no internet access but can reach an external main Harbor registry.
• local_repository: A fully air-gapped environment. Files and images are delivered by USB or another offline method, and the Harbor registry runs on the target server.

For remote_repository and local_repository, specify the Harbor address and project.

repository_registry=<Harbor address:port>
repository_project=eva

Version Management

The versions of EVA App, Agent, Vision, Helm charts, and the n8n image are centrally managed in versions.json. Changes to this file are automatically reflected in Ansible deployment and offline download scripts.

Installation Preparation by Environment

• In a cloud environment, configure Ansible and AWS credentials on the target server and run the installation directly.
• In a remote environment, install Harbor on an internet-connected main server, push the images, and run Ansible from the main server against the target server.
• In a local air-gapped environment, prepare packages, models, images, and the Harbor installer on an internet-connected server. Transfer repository-images.tar and the full project to the air-gapped server, then install Docker and local Harbor and push the images.

For an air-gapped installation, download Docker, Ansible, and APT dependency packages in advance. The preparation server and installation server should use the same Ubuntu release and architecture.

Overall Installation Sequence

1. Create inventory.ini.
2. Run server prerequisite checks.