# Add devices

Source: [https://docs.aventail.co.uk/docs/fleet/overview](https://docs.aventail.co.uk/docs/fleet/overview)

Add a computer to your organisation with **Add devices**. Create a key, run the command for that computer, then check it appears online.

### Add a device to the fleet

Development Control, 2 October 2026. Keys and identifying details are obscured.

1.  **Open Add devices**
    
    Select Add devices at the top right, then Create a key.
    
    [Screenshot: Add devices action — close-up from Fleet operations.](https://docs.aventail.co.uk/img/guides/context/fleet-devices.png)
    
2.  **Create a key inside Add devices**
    
    Select Add devices → Create a key. Give the key a label that identifies the installation or rollout, then select Create key.
    
    [Screenshot: Add devices dialog with a label and Create key action.](https://docs.aventail.co.uk/img/control/fleet-2026-10-02/add-devices-create-key.png)
    
3.  **Save the key before closing**
    
    The new secret appears once. Save it securely before selecting Done; the commands also contain the secret.
    
    Shared key notice shown with the value hidden. This screenshot-only key was revoked immediately after capture.
    
    [Screenshot: One-time fleet key notice telling the user to copy the key before closing, with the key value obscured.](https://docs.aventail.co.uk/img/control/fleet-2026-10-02/add-devices-key-created.png)
    
4.  **Choose the target computer’s platform**
    
    Select Linux, macOS or Windows. Use Install and enroll for a new installation, or the separate existing-install command. Preserve the Control environment shown in the command.
    
    [Screenshot: Add devices dialog with macOS selected and install and existing-install commands using a placeholder key.](https://docs.aventail.co.uk/img/control/fleet-2026-10-02/add-devices-macos.png)
    
5.  **Confirm the device is online**
    
    Find the enrolled device and check its version and configuration. Wait for configured models to finish downloading, then test a response.
    
    [Screenshot: Filtered device table with Documentation Mac online, Aventail 2.0.0 and configuration v7.](https://docs.aventail.co.uk/img/control/fleet-2026-10-02/device-online.png)
    

Already registered?

Enrolling an already configured Aventail Link installation replaces its previous registration. In the macOS 2.0.0 walkthrough, Link deregistered the old device and cleared its deployments before joining the fleet. Check that this is the intended move before running the command.

**Read the device enrollment steps**

## Open your organisation

Open **Fleet operations** in the intended organisation. You need an available device slot and permission to create a fleet key; **Fleet Admin** and **Super Admin** include that permission. An administrator can supply a key if you cannot create one.

If your account shows **Try Fleets free for a month**, follow that offer to name a new organisation and create its first key. Availability depends on account eligibility and the offer period. An existing organisation should use its own Fleet page.

A trial organisation can become read-only when the trial ends. Its devices, models and settings remain visible, but enrollment and configuration changes are disabled. Follow the banner to restore access; key revocation remains available.

## Create a key and enroll

1.  Select **Add devices → Create a key**.
2.  Enter a label that explains its purpose, such as *Mac onboarding*, and select **Create key**.
3.  Save the key securely. The full value is shown only once; closing it displays **Have you copied the key?**
4.  Choose **Linux**, **macOS** or **Windows** for the computer you are adding.
5.  On that computer, use **Install and enroll**, or the separate command under **Aventail Link already installed?** Keep the API address from Control's command so it connects to the correct environment.
6.  Return to **Devices** and find the computer. Confirm **online**, the expected agent version and its configuration revision.

The generated commands contain the key. Do not share them or leave the secret in shell history. To use a protected file, replace the key value in the generated command with `file:/path/to/fleet-key`, retaining the other environment values.

### Install and enroll from a terminal

These examples target **production**. For development or staging, copy the command from that Control environment instead. Replace `YOUR_FLEET_KEY` with your key, or a protected `file:/path/to/fleet-key` value. Do not set the key on `curl`: it must reach the shell running the installer.

**macOS / Linux:**

```bash
curl -fsSL https://get.aventail.co.uk/install.sh | LINK_API_BASE='https://api.locai.co.uk/api/v1' AVENTAIL_FLEET_KEY='YOUR_FLEET_KEY' sh
```

**Windows PowerShell:**

```powershell
$env:LINK_API_BASE = 'https://api.locai.co.uk/api/v1'
$env:AVENTAIL_FLEET_KEY = 'YOUR_FLEET_KEY'
try { & ([scriptblock]::Create((irm https://get.aventail.co.uk/install.ps1))) }
finally { Remove-Item Env:AVENTAIL_FLEET_KEY }
```

For an existing installation, use `aventail register` with the same environment values. If the macOS desktop executable is not on your PATH:

```bash
LINK_API_BASE='https://api.locai.co.uk/api/v1' AVENTAIL_FLEET_KEY='file:/path/to/fleet-key' \
  "$HOME/Library/Application Support/Aventail-Link/aventail" register
```

The file must exist on the computer being enrolled and be readable only by its intended user. On Windows, the equivalent value is `file:C:\path\to\fleet-key`. The screenshots show the captured interface; use the current copyable commands above or those generated by Control.

## Confirm the result

New enrollments use the latest published fleet configuration. In the observed walkthrough, the new Mac reported revision v7 and began downloading its configured Gemma model automatically. **Online** does not mean every model is downloaded or ready to answer: inspect the device and run a small inference test.

See [Monitor a fleet](https://docs.aventail.co.uk/docs/fleet/dashboard) for device health and configuration status. If registration fails, check fleet capacity, the key's status, network access and the Control environment before retrying.

## Work through a small test first

Start with one test device. Confirm enrollment and a successful response before expanding. When enrollment is complete, [revoke the temporary key](https://docs.aventail.co.uk/docs/fleet/keys-and-analytics#revoke-a-key).

Next: [manage enrollment keys](https://docs.aventail.co.uk/docs/fleet/keys-and-analytics), [publish a fleet configuration](https://docs.aventail.co.uk/docs/fleet/config-and-rollouts), or [configure routing](https://docs.aventail.co.uk/docs/fleet/routing).