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
- 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:16andclamav/clamav:1.4to your registry and setglobal.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 - 02
Install PostgreSQL from your own mirror (Linux server)
install.shnormally downloads PostgreSQL 16. Install it from your offline package mirror first, andinstall.shuses the one already running.- Or set
EVENTIER_BUNDLED_POSTGRES=falseand pointDATABASE_URLat your own
- Or set
- 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 - Keep Evee off (
- 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 internalor your own certificate in the Caddyfile - Kubernetes and a server: your ingress or reverse proxy holds the certificate as usual
- Docker Compose: use
- 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, orclamav.enabled: falseon Kubernetes - Keep it on:
CLAMAV_NO_FRESHCLAMD=trueon Docker Compose,clamav.signatureUpdates: falseon Kubernetes, or turn offclamav-freshclamon a server - Download the files on a connected machine with
cvdupdatefrom 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 - Turn scanning off:
- 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 onceclamav.signatureUpdatesis false.