Add a machine by copying the files over

How to set this up

  1. Press Show the files. It opens the folder with the agent builds and install-agent.sh. Put these in one folder on the machine: vantage-agent from the folder named for that machine (x86_64-linux or aarch64-macos), install-agent.sh, and the packaging folder. On a Mac, also vantage-helper from the same folder as its agent.
  2. On the machine, run the install command from the folder you copied into. It installs the agent as a service.
  3. Then run the pairing command on that machine, and enter the address and code it prints in the pairing steps here.
  4. On a Mac, the agent runs as its own user, so it cannot read files inside a home folder. It comes with a log helper that reads them for it, as the person who installed it: Colima's Docker, and only the log files that person lists, one at a time, with sudo /Library/PrivilegedHelperTools/com.avyra.vantage-helper allow <path> on that Mac. When a helper build sits beside the Mac agent, the Mac command installs it too.

Something not working?

  • A file is marked not staged: put the agent build in the releases folder as <machine kind>/vantage-agent, then press Show the files again.
  • The install command says it needs root: run it with sudo, as the copied command does.
  • The code is wrong or has run out: run sudo vantage pair on the machine for a new one.
  • Pairing cannot reach the address: check that the machine's port 9736 is open from this Mac.