# Aventail documentation

> Guides for installing Aventail Link, running models on your devices, chatting in Workspace, connecting software and administering fleets.

Aventail is the current brand; version 1.x is Locai Link (Legacy Aventail), while version 2.x is Aventail Link. Historical UI labels, commands and service addresses can retain Locai names. Start with Quick start. Control manages devices and deployments; Aventail Link runs on the device; Workspace provides chat. Production and development Control are separate environments. Follow the version, platform and environment notes on each page. Historical release notes describe earlier releases.

Each link below provides Markdown generated from the published page, including written steps, code, tables and every walkthrough caption. Each Markdown page links back to its canonical web page.

## Get started

- [Welcome to Aventail](https://docs.aventail.co.uk/docs/index.md): Run AI on your devices. Chat in Workspace or connect a model to your software.
- [Quick start](https://docs.aventail.co.uk/docs/getting-started/quickstartguide.md): Follow the illustrated steps to install and connect Link, deploy a model, then chat in Workspace or connect your software.

## Control

- [Control overview](https://docs.aventail.co.uk/docs/control.md): Use Control to manage devices, models and deployments.
- [Initial setup](https://docs.aventail.co.uk/docs/getting-started/initial-setup.md): Sign in to Control, connect your device, deploy a model and start serving.
- [Notifications](https://docs.aventail.co.uk/docs/getting-started/notifications-hub.md): Find alerts, uploads and deployment progress in Control.
- [View and export results](https://docs.aventail.co.uk/docs/getting-started/view-and-export-results.md): Filter inference records in Control and export selected columns as CSV.
- [Removing models](https://docs.aventail.co.uk/docs/model_management/removing-models.md): Remove a model from one device or delete an owned model from the library.

## Aventail Link

- [Restart Link](https://docs.aventail.co.uk/docs/getting-started/restarting-loc-ai-link.md): Start or restart an installed Link service without repeating registration.
- [Manage Link models](https://docs.aventail.co.uk/docs/link-app/deploy-models.md): Add, serve and remove models on a Link device.
- [Link file locations](https://docs.aventail.co.uk/docs/link-app/file-locations.md): Find Link's installation, models and logs without editing its identity files.
- [Install Link on Linux](https://docs.aventail.co.uk/docs/link-app/install-linux.md): Install Aventail Link on Linux x64, register it with Control and check the user service.
- [Install Link on macOS](https://docs.aventail.co.uk/docs/link-app/install-macos.md): Install the Aventail Link 2.0.0 package for your macOS user and connect it to Control.
- [Link menu bar](https://docs.aventail.co.uk/docs/link-app/menu-bar-companion.md): Check Link and open its model controls from the macOS menu bar.
- [Link overview](https://docs.aventail.co.uk/docs/link-app/overview.md): Install and operate the service that runs models on your device.
- [Link preferences](https://docs.aventail.co.uk/docs/link-app/preferences.md): Check your device, manage models and choose startup and appearance settings.
- [Re-register a device](https://docs.aventail.co.uk/docs/link-app/re-register.md): Change a device's account registration and check that the new identity takes effect.
- [Uninstall Link](https://docs.aventail.co.uk/docs/link-app/uninstall.md): Remove Link and its local data, then check the device record in Control.

## Workspace

- [Chat in Workspace](https://docs.aventail.co.uk/docs/workspace/getting-started.md): Use your Link model for a first chat, then work with documents in Workspace.

## Fleet

- [Fleet configuration](https://docs.aventail.co.uk/docs/fleet/config-and-rollouts.md): Publish a revision, apply it in stages and check device convergence.
- [Monitor a fleet](https://docs.aventail.co.uk/docs/fleet/dashboard.md): Read device health and configuration state, and retire a device carefully.
- [Enrollment keys](https://docs.aventail.co.uk/docs/fleet/keys-and-analytics.md): Create a fleet enrollment key independently, track its use, and revoke it when finished.
- [Add devices](https://docs.aventail.co.uk/docs/fleet/overview.md): Create a fleet key, install or enroll Aventail Link, and confirm the device is online.
- [Routing](https://docs.aventail.co.uk/docs/fleet/routing.md): Assign devices to policies, build routing rules, and verify on-device inference with a cloud fallback.
- [Team](https://docs.aventail.co.uk/docs/fleet/team.md): Choose a built-in role and manage an existing organisation member's access.

## Integrations and local API

- [Connect your software](https://docs.aventail.co.uk/docs/getting-started/run-first-interface.md): Send your first API request to a local model, then connect your application.
- [Obsidian Smart Composer](https://docs.aventail.co.uk/docs/integration/obsidian.md): Connect Obsidian Smart Composer to a Link language model.
- [OpenClaw](https://docs.aventail.co.uk/docs/integration/openclaw.md): Configure a Link language model as a custom OpenClaw provider.
- [Open WebUI](https://docs.aventail.co.uk/docs/integration/openwebui.md): Connect Open WebUI to a model served by Link.
- [Continue in VS Code](https://docs.aventail.co.uk/docs/integration/vscode.md): Connect Continue to a language model served by Link.
- [Aventail Link integration reference](https://docs.aventail.co.uk/docs/integration/your-own-software.md): Discover Link, connect to its local language-model endpoint and handle failures.

## Reference

- [API reference](https://docs.aventail.co.uk/docs/api/overview.md): Distinguish local model inference from Control's management API.
- [Plan a deployment](https://docs.aventail.co.uk/docs/guides/deployment.md): Validate a model on one device before a wider rollout.
- [Manage models](https://docs.aventail.co.uk/docs/guides/models.md): Choose, upload and maintain models in Control.
- [Security and access](https://docs.aventail.co.uk/docs/guides/security.md): Review account access, local endpoints and data handling before sharing a deployment.
- [Glossary](https://docs.aventail.co.uk/docs/introduction/glossary.md): Terms used in Aventail setup, serving and fleet management.
- [Architecture and data flow](https://docs.aventail.co.uk/docs/introduction/platform-architecture.md): How Control, Link, Workspace and your applications work together.
- [Compatibility and versions](https://docs.aventail.co.uk/docs/introduction/versions-and-supported-models.md): Check package availability, model formats and the versions used in the walkthrough.
- [Try the local API](https://docs.aventail.co.uk/docs/playground.md): Send a real request to your locally served model.
- [Usage analytics and privacy](https://docs.aventail.co.uk/docs/privacy/usage-analytics.md): Find Control's usage-analytics preference and distinguish it from device telemetry.

## Troubleshooting

- [Link troubleshooting](https://docs.aventail.co.uk/docs/link-app/troubleshooting.md): Diagnose agent, registration and model problems without resetting the installation.
- [Connection troubleshooting](https://docs.aventail.co.uk/docs/troubleshooting/common-issues.md): Diagnose a registered device that remains Pending or Offline.
- [Document and connection errors](https://docs.aventail.co.uk/docs/workspace/troubleshooting-document-too-large.md): Distinguish document limits from browser access and serving problems.

## Optional

- [Control release notes](https://docs.aventail.co.uk/docs/changelog/control.md): Historical release notes. Dated control release history and links to current guidance.
- [Documentation release notes](https://docs.aventail.co.uk/docs/changelog/documentation.md): Historical release notes. Dated documentation release history and links to current guidance.
- [Aventail Link release notes](https://docs.aventail.co.uk/docs/changelog/link.md): Historical release notes. Dated link release history and links to current guidance.
- [Workspace release notes](https://docs.aventail.co.uk/docs/changelog/workspace.md): Historical release notes. Dated workspace release history and links to current guidance.
- [Complete documentation](https://docs.aventail.co.uk/llms-full.txt): All current guides and explicitly labelled historical release notes in one file.
- [Sitemap](https://docs.aventail.co.uk/sitemap.xml): Canonical web page URLs.