Requirements
What you need before you install EvenTier on Docker Compose, Kubernetes or a Linux server.
- Where
- Account console (/account) → Deploy
- Permission
- Account member (bundles, license) · admin of the host, cluster or server
- Updated
- October 2026
Before you start
Start with a self-hosted account: choose Self-hosted when you sign up. You get a 14-day evaluation license for 20 agents, with no card needed.
Pick one of three ways to run EvenTier. The table below compares what each needs.
Every path needs PostgreSQL 16 (bundled, or your own), a web address people will open, and an SMTP relay for email unless you turn email off.
One license covers one production install plus a staging install.
Step by step
- 01
Choose how to run it
All three run the same product. Pick the one your team already operates.
- Docker Compose: one Linux host, the quickest start
- Kubernetes: the Helm chart, for clusters you already run
- Linux server: a release tarball run by systemd, without containers
- 02
Size the host
Docker Compose needs 4 vCPUs and 8 GB of memory. Malware scanning (clamd) alone needs 3 to 4 GB of memory.
- Give clamd its own room on Kubernetes and on a server too
- 03
Plan the web address and HTTPS
Choose the hostname people will open, and how HTTPS is handled.
- Docker Compose: Caddy gets a certificate for a public DNS name with ports 80 and 443 open, or uses
tls internalfor an internal name - Kubernetes: your ingress controller and a TLS certificate Secret
- OpenShift: a Route through the router, with its default certificate or yours
- Linux server: your own reverse proxy in front of 127.0.0.1:3000
- Docker Compose: Caddy gets a certificate for a public DNS name with ports 80 and 443 open, or uses
- 04
Plan the database
Use the bundled PostgreSQL 16, or point EvenTier at your own.
- On a server,
install.shinstalls PostgreSQL 16 for you, which needs package downloads - Back up the database together with
SECRET_ENCRYPTION_KEY
- On a server,
- 05
Plan notifications
In-app notifications are always on. Email and text messages are optional, and an install starts without either.
- Email: your SMTP relay. Until
SMTP_HOSTis set, notifications are in-app only - Text messages: Amazon SNS or your own gateway, for sign-in codes
- Without email, people sign in with passwords an administrator sets, or through SSO
- Email: your SMTP relay. Until
- 06
Plan storage on Kubernetes
The chart creates volumes for the database, attachments and ClamAV's signatures.
- A default StorageClass, or one you name in
global.storageClass - For more than one web replica, an S3-compatible bucket for attachments
- A default StorageClass, or one you name in
What each path needs
| Requirement | Docker Compose | Kubernetes | Linux server |
|---|---|---|---|
| Platform | Linux host with Docker Engine 24+ and Compose 2.20+ | A cluster with Helm 3 and an ingress controller, or OpenShift 4.11+ | Linux x86-64 with systemd and OpenSSL 3: Ubuntu 22.04+, Debian 12+ or RHEL 9+ |
| Size | 4 vCPUs, 8 GB memory | Room for the app, PostgreSQL and clamd (3 to 4 GB) | Room for the app, PostgreSQL and clamd (3 to 4 GB) |
| Database | PostgreSQL 16, bundled or your own | PostgreSQL 16, bundled or your own | PostgreSQL 16, installed by install.sh or your own |
| HTTPS | Caddy, included | Your ingress and certificate, or an OpenShift Route | Your reverse proxy |
| Storage | Docker volumes | A default StorageClass, or global.storageClass | Local disk |
| Malware scanning | clamd, included | clamd, included | Your own clamd on 127.0.0.1:3310 |
| Attachments | A volume, or an S3-compatible bucket | An S3-compatible bucket for production | A local folder, or an S3-compatible bucket |
| Notifications | In-app; email once an SMTP relay is set | In-app; email once an SMTP relay is set | In-app; email once an SMTP relay is set |
Good to know
- No internet on the host? Read Air-gapped installs before you start.
- Every bundle download generates new secrets. Keep the first bundle's settings file for the life of the install.