---
title: "Offline mode configuration"
---

## ((Offline installation|offline installation)) {#offline-install}

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](https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-10-x86_64/).
- [RHEL/CentOS 9 RPMs](https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-9-x86_64/).
- [RHEL/CentOS 8 RPMs](https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-8-x86_64/).

#### 64-bit ARM

- [RHEL/CentOS 10 RPMs](https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-10-aarch64/).
- [RHEL/CentOS 9 RPMs](https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-9-aarch64/).
- [RHEL/CentOS 8 RPMs](https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-8-aarch64/).

### Example install commands for offline mode
The first step is to download the [runZero platform](https://console.runzero.com/deploy/download/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:
```bash
./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.
```bash
./runzero-platform-[VERSION]-linux-amd64.bin install --offline --distro-packages-only
```

Remember to use `su -` on Debian, not just `su`.

<div class="alert alert-info">
<svg class="alert-icon" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"></circle><line x1="12" y1="16" x2="12" y2="12"></line><line x1="12" y1="8" x2="12.01" y2="8"></line></svg>
<div class="alert-body">
Some components of the application still reference the name "Rumble" for backwards compatibility. The documentation will be updated as these are changed.
</div>
</div>

## 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 {#offline-update}

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](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.
```bash
runzeroctl update runzero-platform-update-[VERSION].zip
```
```bash
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.