Install VS Code / Cursor¶

eve-iac is not an official EVE-NG, VS Code, or Cursor product.

1. Agent on the EVE server¶

Download eve-iac-agent_0.4.2-2_amd64.deb from the GitLab Release (or make deb locally). Install it on the EVE host:

sudo dpkg -i eve-iac-agent_0.4.2-2_amd64.deb
sudo systemctl status eve-iac-agent

Expect active (running). From a host that can reach the agent:

curl -k -sS https://127.0.0.1:8787/api/v1/health

Laptops use https://<EVE_SERVER_IP>:8787 (or the hostname you put in the certificate).

Fingerprint to compare when the IDE asks you to Trust (the certificate directory is mode 0700):

sudo openssl x509 -noout -fingerprint -sha256 -in /opt/unetlab/addons/eve-iac-agent/tls.crt

If that file is missing:

sudo openssl x509 -noout -fingerprint -sha256 -in /opt/unetlab/go/server.crt

Copy the SHA-256 line (after =) into Configure Connection.

2. VSIX on the laptop¶

Download eve-iac-client-0.4.2.vsix from the same GitLab Release (or make vsix locally). It is not on the VS Code Marketplace.

1. Open VS Code or Cursor.
2. Extensions → … → Install from VSIX… → eve-iac-client-0.4.2.vsix.
3. File → Open Folder → a Git folder that will hold IaC/<lab>/.
4. Confirm the EVE IaC Activity Bar icon is present.

Keep one eve-iac window as the owner. A second window is rejected (session_already_active).

Do not create .vscode/mcp.json or .cursor/mcp.json. Copilot and Cursor attach over stdio in the owner window.

Next: Connect to EVE.