Not an official Arcane project

Install the Arcane Edge Agent
in one command

Install the Arcane Edge Agent on a remote host. Runs as a system service (systemd on Linux, launchd on macOS)

curl -fsSL https://arcane-install.espensgr.dev/install.sh | sudo
          bash

Requires root. Run on the remote host you want to connect to Arcane. Supports Linux (x86_64 / arm64 / armv7 / 386 / riscv64) and macOS (Intel / Apple Silicon).

This installs the Arcane Edge Agent — a remote service that connects Docker hosts to your Arcane Manager. Looking for the Arcane CLI? See the official CLI docs.

Agent Options

Flag	Default	Description
`--token`	prompted	Agent token from Arcane Manager (`arc_...`)
`--manager-url`	prompted	Arcane Manager URL (e.g. `https://arcane.example.com` or `http://localhost:3552`)
`--transport`	`poll`	`poll` (periodic check-in) or `auto` (persistent tunnel)
`--version`	latest	Install a specific version (e.g. `2.8.1` or `v2.8.1`)
`--projects-dir`	`/var/lib/arcane-agent/projects`	Path where project files are stored

Script Options

Flag	Description
`--status`	Check if the agent is running and connected.
`--logs`	Follow live agent logs.
`--edit-config`	Open agent config in `$EDITOR` (default: nano).
`--start`	Start the agent service.
`--stop`	Stop the agent service.
`--restart`	Restart the agent service.
`--update`	Re-download latest binary using existing config.
`--reinstall`	Force reinstall even if already on the same version.
`--debug`	Print line number and command on error for troubleshooting.

Non-interactive Usage

curl -fsSL https://arcane-install.espensgr.dev/install.sh | sudo
              bash -s -- --token arc_XXX --manager-url
              https://arcane.example.com

Edge

Requirements

Linux (x86_64 / arm64 / armv7 / 386 / riscv64) or macOS (Intel / Apple Silicon)
Docker (auto-installed if missing on x86_64, arm64, armv7; must be pre-installed on 386 and riscv64)
Linux: curl, systemctl, useradd
macOS: curl, launchctl — Homebrew + colima auto-installed if missing
Environment created in Arcane Manager before running
Agent token copied from Arcane Manager

After Install

sudo ./install.sh --status Status

sudo ./install.sh --logs Live logs

sudo ./install.sh --edit-config Edit config

sudo ./install.sh --start / --stop / --restart Start / Stop / Restart

sudo ./install.sh --debug Debug

Uninstall

sudo ./uninstall.sh Interactive

curl -fsSL https://arcane-install.espensgr.dev/uninstall.sh |
              sudo bash

Remote

Removes binary, config, service, and system user. Prompts for confirmation. Safe to run if already removed.