Not an official Arcane project
Install the Arcane Agent
in one command
Connect remote system to your Arcane Manager. Downloads the latest binary and sets up a systemd service automatically.
curl -fsSL https://arcane-install.espensgr.dev/install.sh | sudo
bash
Requires root. Run on the remote host you want to connect to Arcane. Linux only (x86_64 / arm64).
Connection Modes
Direct Port 3553
Manager connects to the Agent. Requires inbound TCP 3553 on the Agent host.
AGENT_MODE=true EDGE_TRANSPORT=poll AGENT_TOKEN=arc_...
MANAGER_API_URL=http://...
Edge NAT-friendly
Agent connects outbound to Manager. Works behind firewalls and NAT — no inbound port needed.
EDGE_AGENT=true EDGE_TRANSPORT=poll AGENT_TOKEN=arc_...
MANAGER_API_URL=http://...
Script Options
| Flag | Default | Description |
|---|---|---|
--mode |
prompted | direct or edge |
--token |
prompted | Agent token from Arcane Manager (arc_...) |
--manager-url |
prompted |
Arcane Manager URL (e.g. http://10.1.1.4:3552)
|
--transport |
poll |
poll (periodic check-in) or
auto (persistent tunnel)
|
--port |
3553 |
Agent listen port — direct mode only |
--listen |
0.0.0.0 |
Bind address — direct mode only. Empty = all interfaces |
Non-interactive Usage
curl -fsSL https://arcane-install.espensgr.dev/install.sh | sudo
bash -s -- --mode edge --token arc_XXX --manager-url
http://10.1.1.4:3552
Requirements
- Linux — x86_64 or arm64
- Docker installed on the host
-
curl,systemctl,useraddavailable - Environment created in Arcane Manager before running
- Agent token copied from Arcane Manager
After Install
systemctl status arcane-agent
Status
journalctl -u arcane-agent -f
Live logs
sudo nano /etc/default/arcane-agent
Edit config
sudo systemctl restart arcane-agent
Restart