Skip to content
You're viewing documentation for v2026.11.5-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview
On this page

Airgapped install

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.

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

Run the installer

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

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.

Select the package option

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

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 showsThe table of console and server package files that the installer shows

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.

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

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 from the step Log in. For a license without internet access, see 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:

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

Upgrade

Make the new package

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

Run the install commands

On the console host, run the two commands of Install from the offline/airgapped 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 and Upgrade.