Offline mode configuration

View as Markdown

Supported operating systems

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

Note that for offline installs, PostgreSQL packages must be 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 whatever PostgreSQL version your OS provides (must be PostgreSQL 14 or newer).

Offline installation

The self-hosted runZero platform comes with a few options for your installation. You can utilize these options by adding flags to the install command. The current flags available are --offline, --postgres-version, --distro-packages-only, and --postgres-rpm-directory.

--offline
Configures the installation for operation without internet access. Network access may still be necessary during the installation to acquire dependencies. The installer uses the upstream postgresql.org packages by default and this can be disabled by specifying the options below.
--postgres-version
Specify a particular major version of PostgreSQL (14-18). If your operating system does not include the default version of PostgreSQL (18), you may need to use the PostgreSQL.org packages instead, which may include downloading them ahead of time for an offline installation.
--distro-packages-only
Install the platform without using third-party repositories. The install will try to acquire the PostgreSQL package from the configured operating system repositories (local or remote). If no repository is reachable, these packages can also be specified as a directory on the file system using the option below. Note that OS packages may be limited to older versions of PostgreSQL.
--postgres-rpm-directory [directory]
Install using supplied PostgreSQL RPM files (requires RHEL or CentOS). The installer will use the RPMs in the specified directory to satisfy the PostgreSQL dependencies.

By default, the console will be installed to /opt/runzero. If you need to change this, you can use the --install-directory [directory] option.

PostgreSQL RPMs required for --postgres-rpm-directory

There are four RPMs required for installing PostgreSQL:

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

x86_64 Intel

64-bit ARM

Example install commands for offline mode

The first step is to download the runZero platform

RHEL/CentOS 8, 9, or 10

  1. Download the required RPMs 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

Remember to use su - on Debian, not just su. On distributions whose default PostgreSQL is older than 14, supply a newer PostgreSQL via --postgres-rpm-directory (RHEL/CentOS 8/9/10) or your own offline mirror.

Some components of the application still reference the name "Rumble" for backwards compatibility. The documentation will be updated as these are changed.

Enabling offline mode for existing installs

  • Open /etc/runzero/config with an editor of your choice.
  • Look for OFFLINE= and change it to OFFLINE=true.
  • Restart the runZero service runzeroctl restart.

CLI update with offline mode

The self-hosted runZero platform must be updated prior to 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

You will need to change the version to match the zip archive you downloaded.

Updated