Offline mode configuration

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

• RHEL/CentOS 10 RPMs.
• RHEL/CentOS 9 RPMs.
• RHEL/CentOS 8 RPMs.

64-bit ARM

• RHEL/CentOS 10 RPMs.
• RHEL/CentOS 9 RPMs.
• RHEL/CentOS 8 RPMs.

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 10+, or RHEL/CentOS 8, 9, or 10

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.

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

• Go to https://console.runzero.com/deploy/download/platform.
• Copy the command directly from the download page and run it in your terminal, or you can use one of the following commands to update using the zip archive you downloaded.

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.