Skip to content

Documentation

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

  1. 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
  2. 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
  3. 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 internal for 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
  4. 04

    Plan the database

    Use the bundled PostgreSQL 16, or point EvenTier at your own.

    • On a server, install.sh installs PostgreSQL 16 for you, which needs package downloads
    • Back up the database together with SECRET_ENCRYPTION_KEY
  5. 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_HOST is 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
  6. 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

What each path needs

RequirementDocker ComposeKubernetesLinux server
PlatformLinux 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+
Size4 vCPUs, 8 GB memoryRoom for the app, PostgreSQL and clamd (3 to 4 GB)Room for the app, PostgreSQL and clamd (3 to 4 GB)
DatabasePostgreSQL 16, bundled or your ownPostgreSQL 16, bundled or your ownPostgreSQL 16, installed by install.sh or your own
HTTPSCaddy, includedYour ingress and certificate, or an OpenShift RouteYour reverse proxy
StorageDocker volumesA default StorageClass, or global.storageClassLocal disk
Malware scanningclamd, includedclamd, includedYour own clamd on 127.0.0.1:3310
AttachmentsA volume, or an S3-compatible bucketAn S3-compatible bucket for productionA local folder, or an S3-compatible bucket
NotificationsIn-app; email once an SMTP relay is setIn-app; email once an SMTP relay is setIn-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.