Offline mode configuration

View as Markdown

Supported operating systems

The runZero self-hosted console runs on the same operating systems whether you install online or offline: Ubuntu 18.04+, RHEL 7+, CentOS 7+, Oracle Linux 7+, and Debian 9+, on x86_64. See Supported operating systems in Self-hosting runZero for the full list.

Offline installs need PostgreSQL packages available locally. The PostgreSQL.org RPM bundles linked below cover RHEL/CentOS 8, 9, and 10. On older or other distributions, supply PostgreSQL through your own offline mirror, or use --distro-packages-only to install the PostgreSQL version your OS provides (it must be PostgreSQL 14 or newer).

Offline installation

The install command accepts these flags: --offline, --postgres-version, --distro-packages-only, and --postgres-rpm-directory.

--offline
Configures the installation to run without internet access. The installer may still need network access during installation to fetch dependencies. It uses the upstream postgresql.org packages by default; the options below turn that off.
--postgres-version
Selects a major version of PostgreSQL (14-18). If your operating system doesn’t ship the default version (18), you may need the PostgreSQL.org packages instead, which for an offline installation may mean downloading them ahead of time.
--distro-packages-only
Installs the platform without third-party repositories. The installer looks for the PostgreSQL package in the operating system’s configured repositories (local or remote). If no repository is reachable, you can point it at a directory of packages on the file system with the option below. OS packages may be limited to older versions of PostgreSQL.
--postgres-rpm-directory [directory]
Installs from PostgreSQL RPM files you supply (requires RHEL or CentOS). The installer uses the RPMs in the specified directory to satisfy the PostgreSQL dependencies.

The console installs to /opt/runzero by default. To change that, use the --install-directory [directory] option.

PostgreSQL RPMs required for --postgres-rpm-directory

Installing PostgreSQL requires four RPMs:

  • postgresql18
  • postgresql18-server
  • postgresql18-contrib
  • postgresql18-libs

x86_64 Intel

64-bit ARM

Example install commands for offline mode

First, download the runZero platform.

RHEL/CentOS 8, 9, or 10

  1. Download the RPMs listed above and store them in a directory.
  2. Run this install command as root:
./runzero-platform-[VERSION]-linux-amd64.bin install --offline 
    --postgres-rpm-directory [RPM_DIRECTORY]
    --postgres-version=18

Ubuntu 18.04+, Debian 9+, RHEL 7+, CentOS 7+, or Oracle Linux 7+

  1. Run this install command as root:
./runzero-platform-[VERSION]-linux-amd64.bin install --offline --distro-packages-only

On Debian, become root with su -, not just su. On distributions whose default PostgreSQL is older than 14, supply a newer PostgreSQL through --postgres-rpm-directory (RHEL/CentOS 8/9/10) or your own offline mirror.

Some parts of the application still use the name "Rumble" for backwards compatibility. We'll update the documentation as they change.

Enabling offline mode for existing installs

  • Open /etc/runzero/config in an editor.
  • Find OFFLINE= and change it to OFFLINE=true.
  • Restart the runZero service with runzeroctl restart.

CLI update with offline mode

Update the self-hosted runZero platform before first use.

Update the runZero platform and scanners with an offline update

runzeroctl update runzero-platform-update-[VERSION].zip

runzeroctl update --offline --zip-file-path runzero-platform-update-[VERSION].zip

Change the version to match the zip archive you downloaded.

Updated