> ## Documentation Index
> Fetch the complete documentation index at: https://docs.almond.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Offline updates

> Update Axol from a downloaded file when the Host Computer has no internet access.

Every Axol release has an offline bundle for Host Computers that have no internet access. Download the bundle on any computer, then install it from the control panel. The install doesn't use the network.

> [!NOTE]
>
> The offline bundle updates an existing install. The Host Computer needs the [one-command install](https://docs.almond.bot/installation.md) once, with internet access.

## Download the bundle

1. On a computer with internet access, open the [Axol releases page](https://github.com/almond-bot/axol/releases).
2. Under **Assets** for the release you want, download `axol-offline-v<version>-linux-aarch64.tar`. It is about 800 MB.

The `linux-aarch64` bundle is for the Jetson Host Computers that Axol supports. Don't extract it.

## Install from the control panel

1. Bring the bundle to a computer on the robot's network, for example on a USB drive.
2. Open the control panel at `https://<host-ip>:8001` and go to the **Host Computer** card.
3. On the **Offline update** line, press **Install from file**, then **Choose file**, and pick the `.tar` file.
4. Wait for the upload. If the connection drops, choose the same file again to continue where it stopped.
5. The Host Computer checks the file. It installs only bundles signed by Almond, for this computer's platform.
6. Stop any running operation, then press **Install update**.

The banner at the top shows each step of the install. The Host Computer restarts when it finishes, and the panel reloads.

The control panel's usual update banner checks GitHub for releases, so it doesn't appear on a Host Computer without internet access. Install each release from its bundle instead.

To go back to an older release, upload its bundle. The panel says the version is older than the installed one. Press **Use older version** to install it anyway.

## Install over SSH

Use this the first time, when the Host Computer runs a release without **Install from file**. You can also use it instead of the control panel.

1. Copy the bundle to the Host Computer:

   ```bash theme={null}
   scp axol-offline-v0.2.47-linux-aarch64.tar user@<host-ip>:
   ```

2. On the Host Computer, extract the bundle and run its installer:

   ```bash theme={null}
   tar -xf axol-offline-v0.2.47-linux-aarch64.tar
   sudo ./axol-offline-v0.2.47-linux-aarch64/install
   ```

The installer checks every file, installs the release and its software from the bundle, then restarts the `axol` service. You can delete the `.tar` file and the extracted folder afterwards.

## If the install stops

| Message | What to do |
| - | - |
| This file is not signed by Almond. | Download the bundle again from the release page. |
| The bundle is damaged. | Copy or upload the `.tar` file again. |
| This bundle is for `<platform>`, but this computer is `<platform>`. | Download the bundle the message names. |
| The Host Computer needs more free space. | Delete old datasets, then upload the file again. |
| This bundle is signed with a key this version of Axol does not know. | Install it over SSH, as above. |
| Python 3.13 is not installed on this computer. | Run the [one-command install](https://docs.almond.bot/installation.md) once with internet access. Later updates can use the bundle. |

The bundle doesn't include the ZED SDK or Ubuntu packages. The install uses the copies already on the Host Computer. If an optional step needs something that isn't there, the install finishes with a warning that names the step. Axol works without it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.