Skip to main content

Uninstall Link

Uninstalling removes the local runtime, models and configuration. Finish active requests and record what you will need afterward.

AVENTAIL / LINK

Uninstall from Preferences

Full view

Aventail Link Preferences

Danger zone appears at the bottom of Preferences, below General.

Slide 1 of 3: Aventail Link Preferences.

Aventail Link 2.0.0 on macOS. User-supplied Preferences screenshot, 2 October 2026. Use the arrows or progress marks to move between slides.
AVENTAIL / LINK

Uninstall from Preferences

Full view

Aventail Link Preferences

Danger zone appears at the bottom of Preferences, below General.

Slide 1 of 3: Aventail Link Preferences.

Read the uninstall and deregistration steps

Removal affects the local runtime, downloaded models and configuration. Keep a record of anything you need to reinstall.

From the desktop app​

  1. Click Aventail Link's menu-bar icon and open Preferences….
  2. Scroll to Danger zone at the bottom of the window.
  3. Select Uninstall Aventail Link… for the installation you intend to remove. Read any prompts before proceeding.
  4. Check the local installation and the device record in Control afterward. If a record remains, follow Remove a device.

From Terminal​

Use the executable from the installation you intend to remove:

"$HOME/Library/Application Support/Aventail-Link/aventail" uninstall

The 2.0.0 command describes removal of the registration, service, menu entry and all local files. Run it only when you intend to remove that installation and its data; do not assume there will be another confirmation. --keep-registration leaves the Control registration in place while removing the local agent.

Headless installation on Linux, macOS or Windows​

aventail uninstall

This removes the service, local session, logs, engines and models, then attempts to deregister the device in Control. It may run without an additional confirmation. If the device was offline or deregistration fails, remove the remaining record in Control. --keep-registration deliberately retains that remote record. If you used a custom AVENTAIL_BIN_DIR, remove the command link from that custom directory yourself.

A legacy installation uses different files and commands. Check for any legacy remnants after migration; do not delete another installation's files by guessing its path.

Locai Link (Legacy Aventail) 1.x macOS app
  1. Open Preferences → Advanced → Uninstall Locai Link….
  2. Read the removal confirmation and continue if this is the intended device.
  3. Complete the macOS administrator prompt.
  4. Check the outcome in the app and in Control.

Do not assume cancelling one prompt reverses earlier changes; inspect the remaining installation and device record.

Locai Link (Legacy Aventail) 1.x terminal

The CLI exposes:

locai uninstall

Read its output and any confirmation carefully. Platform-specific removal and remote deregistration must be checked separately. In particular, running the macOS package's uninstall script directly does not deregister the device, as documented in the 1.3.2 uninstaller source.

Remove a device​

If a record remains after uninstalling, or a device is no longer available:

  1. Open Devices in Control.
  2. Match the device name and ID, then choose Deregister.
  3. Read the confirmation and confirm only the intended device.

Check that the record disappears and the account's capacity updates. Removing a record cannot erase files from an offline machine. Wipe or uninstall that machine separately before disposal or reuse.

To reconnect later, install and register Link, then deploy the required models.