Quick start
Install Aventail Link on the computer that will run your model, connect it to Control, then use Aventail Connect, Workspace or your own software.
Before you start
For this macOS path, you need an Apple Silicon Mac, internet access, an Aventail account with an available device slot, and enough disk space and memory for a compatible model and its engine. The current production release checked on 1 November 2026 is Link 2.3.2.
For another platform, check available builds and terminal installation. If Link is already registered, confirm the intended account and skip to models. Moving from 1.x has separate migration requirements.
1. Sign in
Open Control using your existing sign-in method. Use the same account when Link asks you to sign in. If you belong to an organisation, check which account or organisation should own the device before approval.
2. Install and connect Aventail Link
In personal Control, select Connect a device → Desktop app, then choose the installer for your computer. Finish setup in Link; downloading a package alone does not connect a device.
Download Link for macOS (Apple Silicon). This is the production release. For a development or staging account, use the download offered by that Control environment.
Connect a device
Slide 1 of 3: Connect a device.
Read the installation and approval steps
- Open the macOS
.pkg, choose Continue → Install, and wait for The installation was successful. Select Close. The observed current package installs for your macOS user without an administrator prompt. - Open Aventail Link Setup. In Connect, select Sign in with Aventail.
- In the browser, check the account, computer and Link version. Compare the approval code with Link, then approve only the computer you intended to connect.
- Return to Link. Continue through Models → Serving → Finish.
Keep approval codes and device identifiers private. If approval expires or is denied, return to Link to start a new sign-in. See macOS installation help.
3. Choose a model and start serving
Choose a compatible model in Link. Review its size and memory needs before starting the download; a suggested model is not downloaded automatically. Keep Link running while it downloads the model and its engine.
Download and serve your first model
Slide 1 of 5: Download and serve your first model.
Read the model setup and verification steps
- In setup's Models stage, select the model you want and start its download. If it fails, read the reason before using Retry. You can use the offered option to set up models later.
- In Serving, enable the installed model if you want to use it now, then finish setup.
- In the main Link window, open Models. For an installed model that is not serving, select Start serving.
- Check the model state. Ready to serve can precede loading into memory; the first request may take longer. If the model fails to load, check its error, available memory and context settings.
- Open Control's Devices page and confirm the device has reported online. A serving configuration accepted by Control is not proof of a completed model response.
To add another model later, use Link model management. In Control, Models holds the registry and Devices holds device installations and actions. A registry entry does not itself mean the model is installed.
4. Get your first response
For supported common apps, start with Aventail Connect: open Link's Connected apps tab and use the Claude example. It includes the complete supported-app list and recovery instructions.
Send a harmless test question. Confirm an answer, then inspect Link’s local state and the reported details in personal Control’s Requests. Personal Control has no routing-policy interface yet. For an organisation-managed device, ask the administrator to verify its applied policy and routing records. A local connection address alone does not mean the request ran locally.
A permitted remote provider receives requests routed to it and may charge for them. Peer and hosted routing remain beta. Connect governs model requests sent through Link, not every connection an app makes.
When finished, use Stop serving for the model in Link. Finish active requests first; the model remains installed for later use.