Skip to main content

Headless Installation

Advanced users — not part of Autodarts Desktop

This is a separate setup path from Autodarts Desktop, the app most people use. Both run the same underlying Detection software, controlled through Board Manager — headless installation just leaves out the application window entirely and is driven purely from the command line. Aimed at advanced users, or low-budget builds on cheap mini computers, where running without a window saves system resources. Linux only.

If you just want to connect a normal board and you're not sure this is for you, it probably isn't — use Autodarts Desktop instead.

Requirements​

Requires curl:

sudo apt install curl -y

(On distributions without apt, use whichever package manager they provide instead.)

Installation​

Install with automatic start on boot:

bash <(curl -sL get.autodarts.io)

Install without the autostart systemd service, using the -n flag:

bash <(curl -sL get.autodarts.io) -n

To install a specific version (useful for downgrading), append it — this also works together with -n:

bash <(curl -sL get.autodarts.io) 0.20.0

Once installed, control the autodarts service with systemctl:

sudo systemctl start autodarts
sudo systemctl stop autodarts
sudo systemctl restart autodarts
sudo systemctl status autodarts
sudo systemctl disable autodarts
sudo systemctl enable autodarts

View its logs with:

journalctl -u autodarts -f

Pairing with your account​

This installs and runs Detection — the same software Autodarts Desktop runs, just without the app window around it. Control and monitor it through Board Manager, reached in a browser at http://localhost:3180 on the machine you installed it on (or that machine's address, if browsing from elsewhere on the same network).

A headless install has no browser to sign in through, so unlike Autodarts Desktop's setup wizard, it isn't paired automatically. Pair it manually instead:

  1. On My Devices, create a board (or use an existing one) and generate a Board ID and API Key for it — the Generate new board ID and API key icon on an existing board's card does this.
  2. Open this instance's Board Manager (localhost:3180) → Config, and enter that Board ID and API Key into the matching fields, then Save.

That connects this Board Manager instance to the board in your account. Unlink on the same Config tab disconnects it again.