Skip to main content

Linux VM's

This guide helps you set up hoop on Linux VMs

Agent

Systemd is recommended and will help on managing the agent in the Linux server.

1. Create a Systemd unit

cat - >/etc/systemd/system/hoopagent.service <<EOF
[Unit]
Description=Hoop Agent
After=network.target

[Service]
ExecStart=hoop start agent
Environment="HOME=/root"
StandardOutput=true
Restart=on-failure
RestartSec=10s

[Install]
WantedBy=multi-user.target
EOF

2. Load and start the unit

systemctl daemon-reload
systemctl enable hoopagent.service
systemctl start hoopagent

3. Visit the URL and register the agent

journalctl -u hoopagent |grep -i 'https://app.hoop.dev/agents/new/x-agt' |tail -n1
https://app.hoop.dev/agents/new/x-agt-...
info

When the VM restarts the agent will be unregistered if you aren't using a persistent volume.