Skip to main content

Quick start

Install Aventail Link, connect your computer to Control, then choose local execution or a cloud model with optional backups. Use Aventail Connect, Workspace or your own software to send requests through Link.

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 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.

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. In 2.4.0, continue through Set up → Ready. Earlier 2.3.x setup uses 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 where to run AI​

In Link 2.4.0, Set up offers Run a local model, Use a cloud model, or Decide later. For a cloud model, Link opens this device’s routing page in Control. Choose the first destination, optionally add backups, review and apply. See Routing and backups for the full cloud-first example with a local fallback.

AVENTAIL / LINK

Connect, set up and get ready

Full view

Choose how this computer will run AI

The new setup has Connect, Set up and Ready. This capture follows browser approval.

Slide 1 of 5: Choose how this computer will run AI.

Link 2.4.0 · Apple Silicon · captured 13 November 2026. Use the arrows or progress marks to move between slides.
AVENTAIL / LINK

Connect, set up and get ready

Full view

Choose how this computer will run AI

The new setup has Connect, Set up and Ready. This capture follows browser approval.

Slide 1 of 5: Choose how this computer will run AI.

Wait for Link to confirm the route and finish preparing any local backup. At Ready, check the displayed order and choose Open Link or Use your model in an app. A cloud-only route does not require a local model download; a local backup does.

For local execution, choose a compatible model and review its size and memory needs. The earlier model-first setup is shown below.

Read the earlier 2.3.x model-first setup and verification steps
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.

  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. For the new personal routing flow, check Devices → your device → Routing and wait for Applied. 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.

To stop ordinary local serving, finish active requests and use Stop serving for that model. This leaves its download in place. A prepared backup and a configured cloud route are separate from ordinary local serving; manage routing in Control.