Install Hubble Without Internet Access

Starting with 26.2, Docker images ship as a self-contained bundle (hubble-docker-images-<version>.tar.gz). The bundle contains images covering all services in the stack. The full list of images is recorded in manifest.txt inside the bundle.

Use --offline when the target machine cannot reach Docker Hub, for example when outbound access to Cloudflare or registry IPs is blocked by a firewall. If network access to Docker Hub is restored later, use --online to re-enable image pulls.

Installation Steps

1. Transfer hubble-docker-images-<VERSION>.tar.gz to the app server, for example via WinSCP or USB.

2. Extract the archive in any directory:

   tar -xzf hubble-docker-images-<VERSION>.tar.gz

3. Load the Docker images:

   sudo ./hubble-load-images.sh

4. Start app server installation in offline mode:

   sudo ./start.sh --offline

Note: Offline mode persists automatically across reboots. Once --offline is used, systemd service restarts continue operating in offline mode without requiring the flag again.

Scripts Supporting Offline Mode

Note: When running via install.sh --offline or start.sh --offline, the flag propagates automatically. If Configuration/start.sh is run directly, pass --offline explicitly:

Switch Back to Online Mode

Offline mode is persisted via the marker file /hubble/data/.offline. As long as this file exists, every startup, including systemd service restarts, operates in offline mode without requiring the flag.

To return to online mode, choose one of the following options:

Option 1: Remove the Marker and Restart Containers

Use this option when you are ready to bring the system online immediately:

This removes /hubble/data/.offline and performs a full container startup, pulling images and starting all services.

Option 2: Remove the Marker Only

Use this option to remove the marker without restarting containers immediately:

Flag Reference