Skip to content

Documentation

Air-gapped installs

Run EvenTier on a network with no internet access: images, HTTPS, malware signatures, AI and the license.

Where
.env (Docker Compose) · values.yaml (Kubernetes) · eventier.env (Linux server)
Permission
Admin of the host, cluster or server
Updated
October 2026

Before you start

EvenTier runs fully offline. The license is checked offline and keeps working 14 days past its expiry date, so the install never needs to contact EvenTier.

Prepare the items below on a machine with internet access, then carry them across.

Each bundle's README has an Air-gapped section with the same steps for its path.

Step by step

  1. 01

    Bring the images in

    Copy the images from a connected machine, or mirror them to a registry inside your network.

    • Docker Compose: save the images to one file and load it on the host (below)
    • Kubernetes: mirror the EvenTier image, postgres:16 and clamav/clamav:1.4 to your registry and set global.imageRegistry
    • Linux server: carry the release tarball across
    Docker Composebash
    # On a connected machine, in the bundle folder
    docker compose pull
    docker save -o eventier-images.tar $(docker compose config --images)
    
    # On the host
    docker load -i eventier-images.tar
  2. 02

    Install PostgreSQL from your own mirror (Linux server)

    install.sh normally downloads PostgreSQL 16. Install it from your offline package mirror first, and install.sh uses the one already running.

    • Or set EVENTIER_BUNDLED_POSTGRES=false and point DATABASE_URL at your own
  3. 03

    Turn on air-gapped mode

    Set AIRGAP=true. It removes the EvenTier support link, which opens the account console on eventier.io.

    • Keep Evee off (AI_DISABLED=true) unless your AI provider runs inside your network
    .env or eventier.envbash
    AIRGAP=true
    AI_DISABLED=true
  4. 04

    Set up HTTPS without the internet

    Public certificate authorities can't reach an air-gapped host, so use a certificate from inside your network.

    • Docker Compose: use tls internal or your own certificate in the Caddyfile
    • Kubernetes and a server: your ingress or reverse proxy holds the certificate as usual
  5. 05

    Malware scanning: off, or with signatures you bring in

    The scanner normally downloads virus signatures. Either turn scanning off, or turn downloads off and copy the signature files in.

    • Turn scanning off: ATTACHMENT_MALWARE_SCANNER=off, or clamav.enabled: false on Kubernetes
    • Keep it on: CLAMAV_NO_FRESHCLAMD=true on Docker Compose, clamav.signatureUpdates: false on Kubernetes, or turn off clamav-freshclam on a server
    • Download the files on a connected machine with cvdupdate from Cisco Talos
    • To update later, copy newer files in the same way
    Download, then load the signature filesbash
    # On a connected machine
    pip install cvdupdate
    cvd update                      # files land in ~/.cvdupdate/database
    
    # Docker Compose, with CLAMAV_NO_FRESHCLAMD=true in .env
    docker compose create clamav
    docker compose cp ./database/. clamav:/var/lib/clamav/
    docker compose up -d
    
    # Linux server
    sudo systemctl disable --now clamav-freshclam
    sudo cp database/*.cvd /var/lib/clamav/
    sudo chown clamav:clamav /var/lib/clamav/*.cvd
    sudo systemctl restart clamav-daemon
  6. 06

    Keep the license current

    Licenses and their revocation list come with releases, so nothing has to reach EvenTier.

    • Download a renewed license from the account console on a connected machine and upload it at Admin > Billing
    • A revoked license keeps working until the next upgrade, whose release carries the revocation list

Good to know

  • Upgrades work the same way: bring the new image or tarball across, then follow Upgrading a self-hosted install.
  • On Kubernetes with networkPolicy.denyExternalEgress, no signature mirror is needed once clamav.signatureUpdates is false.