Setup

Download and install

1. Open Mesh Storage → Devices → Add device and use Track a folder with Alloy Edge.
2. Check the detected operating system and architecture, then download Alloy Edge. On Debian or Ubuntu, choose the recommended .deb package; otherwise choose the standalone binary.
3. Run the install command shown in Add device. If the file was saved outside Downloads, adjust the path in that command.
4. Confirm the installation:

alloy-edge --version

For a standalone binary, the app gives you a command with the exact downloaded filename. It installs the executable as alloy-edge (alloy-edge.exe on Windows) and adds its directory to PATH for the current terminal session. Add that directory to your shell or user PATH to use Alloy Edge in new terminal sessions. On Linux, the standalone binary requires glibc 2.31 or newer. Installing the binary alone does not start a background service. Make sure your recordings folder already exists before linking it.

Choose a key

Open Mesh Storage → Devices → Add device and choose one of these paths:

• Provisioning Key: Use the organization's shared key to enroll a device. The device appears as pending until you approve it in Mesh Storage → Devices. Alloy then issues the device its own API key. Use this path for production devices.
• Device Key: Generate an already-approved API key for a development machine. This path does not need a separate approval step. Copy the key when it is shown; it is only displayed once.

Link a recordings folder

Replace the example path with your recorder's folder. Use the key you chose above:

export ALLOY_PROVISIONING_KEY="paste-key-here"
alloy-edge link --track-folder /data/recordings

export ALLOY_API_KEY="paste-key-here"
alloy-edge link --track-folder /data/recordings

$env:ALLOY_PROVISIONING_KEY = "paste-key-here"
alloy-edge link --track-folder C:\path\to\recordings

$env:ALLOY_API_KEY = "paste-key-here"
alloy-edge link --track-folder C:\path\to\recordings

Set only one of ALLOY_PROVISIONING_KEY or ALLOY_API_KEY.

link stores the configuration. With a provisioning key, it waits up to 60 seconds for approval; approve the pending device in Mesh Storage → Devices. With a device API key, it links without that step.

Run Alloy Edge

Linking does not start Alloy Edge. For the default user installation, run:

alloy-edge run --user

Keep run in the foreground under a supervisor you control. On Linux, you can preview and install a user systemd unit with alloy-edge config --user systemd print and alloy-edge config --user systemd install.

To inspect or change settings later, see Configure.