Zephyrus

Add a server

Install the Zephyrus agent and connect a server to your workspace.

In the console, go to Hub → Agents → Add agent. Give the server a name you'll recognise and pick a key for it. The console then shows you a command with everything filled in. Run it on the server:

curl -fsSL https://console.zephyrus.ameys.eu/install.sh | sudo ZEPHYRUS_SECRET=<key> bash -s -- --agent-id <id>

The installer downloads the agent, checks it hasn't been tampered with, and starts it as a background service. When it's done you'll see:

Successfully installed! web-01 is now connected to Zephyrus.

The server appears in your Agents list with its name, operating system and IP address, and shows Online once it connects.

Running the same install command again on the same server is safe. It updates the agent in place.

Not showing up?

Check the agent is running, and read its most recent output:

systemctl status zephyrus-agent
journalctl -u zephyrus-agent -n 50

If the install command stopped with an error, see Troubleshooting.

On this page