Skip to main content

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.

AVENTAIL / CONTROL

Connect a device

Full view

Connect a device

Choose Desktop app in Connect a device. Install Link on the computer you want to use, then finish setup there.

Slide 1 of 3: Connect a device.

Personal Control · captured 1 November 2026. Use the arrows or progress marks to move between slides.
AVENTAIL / CONTROL

Connect a device

Full view

Connect a device

Choose Desktop app in Connect a device. Install Link on the computer you want to use, then finish setup there.

Slide 1 of 3: Connect a device.

Read the installation and approval steps
  1. 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.
  2. Open Aventail Link Setup. In Connect, select Sign in with Aventail.
  3. 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.
  4. 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.

AVENTAIL / LINK

Download and serve your first model

Full view

Download and serve your first model

After browser approval, Link continues through Models, Serving and Finish. This capture shows the model download has completed.

Slide 1 of 5: Download and serve your first model.

Aventail Link 2.3.2 on macOS · captured 2 November 2026. Model and memory values are examples. Use the arrows or progress marks to move between slides.
AVENTAIL / LINK

Download and serve your first model

Full view

Download and serve your first model

After browser approval, Link continues through Models, Serving and Finish. This capture shows the model download has completed.

Slide 1 of 5: Download and serve your first model.

Read the model setup and verification steps
  1. 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.
  2. In Serving, enable the installed model if you want to use it now, then finish setup.
  3. In the main Link window, open Models. For an installed model that is not serving, select Start serving.
  4. 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.
  5. 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.

Check the allowed destination

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.