---
title: Airgapped install
description: "Install and upgrade a console that has no internet access from one offline/airgapped package, and add a server OS to an air-gapped console later."
sidebar:
  icon: wifi-off
search:
  keywords: ["air gap", "air-gapped", "airgap", "offline", "disconnected"]
seo:
  title: "Air-gapped install of the console"
---

Use this procedure when the console host has no internet access. You make an
offline/airgapped package on a second computer with internet access, then install from it.

## Make the offline/airgapped package

Use a Linux or macOS computer with `curl`, `tar`, `ssh-keygen` (OpenSSH 8.1 or later; macOS
has it) and HTTPS access to `registry-1.docker.io`, `auth.docker.io` and the storage host of
Docker Hub. It needs no Docker and no Docker Hub account. The installer checks the signature
of `SHA256SUMS` of the release before it downloads the other files (see
[The release signing key](/docs/v2026.11.9-beta/verify-a-release#the-release-signing-key)).

1. **Run the installer**

    Download the installer of the release that you want to install, and run it:

    ```bash
    curl -fsSLO https://enterprise.tigerdata.com/install/timescale-enterprise.sh
    sh timescale-enterprise.sh
    ```

    For an earlier release, download `https://enterprise.tigerdata.com/install/<tag>/timescale-enterprise.sh`.

2. **Select the package option**

    Select **Make an offline/airgapped package**. Enter the directory for the package, or
    press Enter for the current directory.

3. **Select the files**

    Select the files, then press Enter:

    - **Console**: the architecture of the console host (`uname -m` on the console host:
      `x86_64` is `amd64`, `aarch64` is `arm64`). The default is the architecture of this
      computer.
    - **Server packages**: each OS version and architecture of your servers. The public beta
      supports `ubuntu-26.04` on `amd64` and `arm64`.

![The table of console and server package files that the installer shows](/docs/screenshots/v2026.11.9-beta/installation-airgapped/make-airgap-package.light.webp)

The installer writes `timescale-enterprise-<tag>-offline.tar`. It holds the console bundle,
the server packages that you selected, the installer, `SHA256SUMS` and its signatures
(`SHA256SUMS.sig` and `SHA256SUMS.cosign.bundle`). Check
the files before you copy the package to the console host. See
[Verify an offline/airgapped package](/docs/v2026.11.9-beta/verify-a-release#verify-an-offlineairgapped-package).

Without a terminal, run `sh timescale-enterprise.sh --make-bundle` with
`--console-arch amd64` and `--servers ubuntu-26.04` (or `all`, the default).

## Install from the offline/airgapped package

The console host needs Docker Engine with the Docker Compose v2 plugin, and `ssh-keygen` of
OpenSSH 8.1 or later (on Ubuntu and Debian, the package `openssh-client`). Install them from
your own package mirror or media (see [Requirements](/docs/v2026.11.9-beta/installation#requirements)). The
installer checks the signature of `SHA256SUMS` in the package before it uses it. The installer
extracts the server packages into `TMPDIR` (default `/tmp`), so that directory needs free
space for them.

Copy the package to the console host, take the installer out of it, and run the install:

```bash
tar -xf timescale-enterprise-<tag>-offline.tar timescale-enterprise.sh
sh timescale-enterprise.sh --offline timescale-enterprise-<tag>-offline.tar
```

The installer extracts the console bundle into the install directory (`--dir`, else
`/opt/tse`) and asks the questions of a normal install. Then it starts the console and loads
the server packages. Continue with the steps of [Install](/docs/v2026.11.9-beta/installation#install) from
the step Log in. For a license without internet access, see
[Air-gapped installs](/docs/v2026.11.9-beta/licensing#air-gapped-installs).

## Add a server OS later

To deploy to an OS version or architecture that the console has no server packages for,
make a file with only those server packages. Use the installer of the release of the
console: the console refuses server packages of a newer release. On the computer with
internet access, run:

```bash
sh timescale-enterprise.sh --make-bundle --packs-only --servers ubuntu-26.04-amd64
```

This writes `timescale-enterprise-<tag>-server-packages.tar`. In
**Administration → Server packages**, select **Upload server packages**, and choose the
file. Or load it on the console host with `./timescale-enterprise.sh --pack <file>` (see
[Load server packages](/docs/v2026.11.9-beta/installation#load-server-packages)).

## Upgrade

1. **Make the new package**

    Make the offline/airgapped package of the new release, with the server packages for all
    your servers.

2. **Run the install commands**

    On the console host, run the two commands of
    [Install from the offline/airgapped package](#install-from-the-offlineairgapped-package)
    with the new package. Add `--dir` if the install is not in `/opt/tse`.

The installer keeps `.env`, upgrades the console, and loads the new server packages. The
console keeps the server packages of earlier releases, because existing services can need
them. See [Remove server packages](/docs/v2026.11.9-beta/server-packages#remove-server-packages) and
[Upgrade](/docs/v2026.11.9-beta/upgrade).
