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

--distro-packages-only

Install the platform without using third-party repositories (not available on RHEL/CentOS 7). 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.

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

• RHEL/CentOS 9 RPMs can be found here.
• RHEL/CentOS 8 RPMs can be found here.
• RHEL/CentOS 7 RPMs can be found here.

There are four RPMs we require for installing PostgreSQL 16:

• postgresql16
• postgresql16-server
• postgresql16-contrib
• postgresql16-libs

Example install commands for offline mode

The first step is to download the runZero platform

RHEL/CentOS 7, 8, or 9

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]

Ubuntu 18.04+, Debian 10+, or RHEL/CentOS 8 or 9

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.