axsDocs
axs build

Machines

Connect the boxes your builds run on.

A machine is any box with Docker: a server, a workstation, a laptop. It runs the axs build agent, which keeps an outgoing connection to build.axs.sh; nothing has to reach the machine from outside. Machines count toward the team's machine quota.

Add a machine

A team owner adds one in the dashboard under build, Machines, or with the CLI:

axs build machine add <name>

Both give a machine token (mbm_...) and the line to run on that machine.

Linux and macOS:

curl -fsSL https://axs.sh/install | sh -s -- mbm_...

It installs axs and starts the agent as a user service (systemd on Linux, a launch agent on macOS).

Windows (PowerShell, needs Docker Desktop):

& ([scriptblock]::Create((irm https://axs.sh/install.ps1))) -Token mbm_...

It starts the agent and again at every login.

Or run the agent yourself:

axs build agent --server https://build.axs.sh --token mbm_... [--slots 2] [--cpus N] [--mem MB]
FlagDefault
--slots2 jobs at once
--cpusHalf of Docker's CPUs per project container
--memHalf of Docker's memory per project container (MB)

See them

axs build machines

Lists each machine with its OS, version, busy slots, reserved CPU and memory, free memory and load. The dashboard shows the same under build, Machines.

On this page