Install Link on macOS
Install Aventail Link on an Apple Silicon Mac. The new package installs for your macOS user and launches Link for setup; start at login is established when setup finishes.
The current setup has three stages: Connect → Set up → Ready. Use the current Link package for your Control account. Earlier versions can show the previous model-first setup.
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, set up and get ready
Slide 1 of 5: Choose how this computer will run AI.
Read the macOS installation details
Download the macOS ARM64 .pkg above for production, or use the download offered by your organisation's development Control environment. Check the version before installing: Locai Link (Legacy Aventail) 1.3.2 uses the older setup and is labelled Locai Link in the installer.
Link 2.4.0 package installation, registration and cloud-first setup with a local backup checked on Apple Silicon on 13 November 2026. Earlier 2.3.2 local-serving setup was checked on 1–2 November. Other platforms have separate installers.
Requirements
You need an Apple Silicon Mac, an available device slot in the intended Control account or organisation, and internet access for sign-in and model downloads. The observed package installation needed no administrator authentication.
The 2.4.0 installer reports 35.2 MB for the application. Models and engines need additional disk space and memory. Check platform availability before using another architecture.
Install the package
- Open the downloaded
.pkg. The window should say Install Aventail Link. - Select Continue, then Install for the standard installation in your home folder.
- Wait for The installation was successful, then select Close. Choose Keep if macOS offers to move the package to the Bin and you want to retain it.
- Continue in the separate Aventail Link Setup window.
This installer has no separate licence step or start-at-login choice. Start at login is established when setup finishes. Files are stored in ~/Library/Application Support/Aventail-Link/.
First-run setup
Link 2.4.0 has three stages: Connect → Set up → Ready.
After browser approval, choose Run a local model, Use a cloud model or Decide later. The cloud choice opens this device in Control, where you select a provider connection, model and optional backups. Reusing a saved provider connection still requires permission for the new device. Follow Routing and backups.
After applying the route, leave Link open. It prepares any selected local backup automatically, then shows Ready with the destination order. Choose Open Link or Use your model in an app. The main window now includes Models, Routing, Connected apps and Settings.
A local backup is prepared without turning on ordinary serving. It loads on its first request; check its status separately from the applied route.
Earlier 2.3.x setup
Download and serve your first model
Slide 1 of 5: Download and serve your first model.
The earlier setup has four stages: Connect → Models → Serving → Finish.
Select Sign in with Aventail. Setup opens your default browser, which may differ from the browser where you opened Control. Check the destination, account and organisation, compare the approval code with Link, then approve the device and return to setup.
- In Models, review the recommended model or expand Choose a different model, then select Download model. A recommendation is not an automatic download. Wait for Downloaded · Ready for the next step, then select Continue.
- In Serving, select Start serving, or choose Do this later. The model loads on its first request unless you later enable Keep loaded.
- At Finish, choose Open Link for the main window or Use your model in an app for Connected apps. The main tabs are Models, Connected apps and Settings.
- If you skipped downloading or serving, return to Models, finish the download and select Start serving first. Confirm Control receives the device's online report, then send a short request. A ready-to-serve label may precede the model loading into memory.
The production 2.3.2 package opens control.aventail.co.uk. Keep the package and account environment together; development registration is separate.
If Locai Link (Legacy Aventail) is already installed
Treat the move to Aventail as a new installation, not a remote 1.x update. Record the old device and required models before starting: the current installer's service setup removes the legacy runtime using its uninstaller where available. The old registration and models do not migrate. Register the new device, deploy the models again and check Control for an old offline record if legacy deregistration could not complete.
If setup stops
| Problem | What to do |
|---|---|
| Setup does not open | Check the installed service using the command below. Do not open the old Locai Link (Legacy Aventail) application to configure Aventail. |
| Browser approval is interrupted | Return to Connect and retry sign-in. Keep approval codes private. |
| Wrong browser account or environment | Check both the browser URL and organisation before approving the device. Use the package intended for that environment. |
| No available device slot | Ask the account owner to make capacity available. Check whether this Mac is already registered before trying again. |
| Registered but not Online | Keep Link running and check Link troubleshooting. Save any error message. |
| No installed model to serve | Return to Models and inspect download progress or the reported failure. Retry only after resolving the cause. |
Earlier 2.0.0 download waiting state
Check the installed version and service:
"$HOME/Library/Application Support/Aventail-Link/aventail" --version
"$HOME/Library/Application Support/Aventail-Link/aventail" status
NeedsSetup means onboarding is still required. A healthy local service does not by itself confirm registration in Control.
Earlier Aventail Link 2.0.0 installation captures
These captures record the 2 October 2026 package. Use the current setup steps above for a new installation.
Install Aventail Link on your Mac
Slide 1 of 10: Aventail Link installer.
Next: check serving or deploy another model, then connect your software.