Configuration

You can configure Keila with environment variables.

Database

Configure the PostgreSQL database used by Keila:

VariableRequiredDefaultDescription
DB_URLyes-URL following the schema postgres://user:password@host/database
KEILA_USERroot@localhostEmail address for the root user
KEILA_PASSWORDrandomPassword for the root user

URL

Configure the URL that Keila uses to generate URLs with the following variables:

VariableRequiredDefaultDescription
URL_HOSTyes-Domain used for URL generation
URL_SCHEMAhttphttp or https. Used for URL generation
URL_PORT80 for schema http
443 for schema https
Used for URL generation

Deployment

VariableRequiredDefaultDescription
PORT4000Port on which Keila will listen
SECRET_KEY_BASEyes-Strong secret with at least 64 characters. Can be generated with `head -c 48 /dev/urandom
DISABLE_REGISTRATIONfalseDisable user registration by setting this variable to true
DISABLE_PRECEDENCE_HEADERfalseDisable the Precedence: Bulk header by settings this variable to true

System mailer

Keila needs to be able to send system emails, e.g. for registration and password reset emails. Configure an SMTP sender for this purpose with the following variables:

VariableRequiredDefaultDescription
MAILER_TYPEsmtpCurrently only smtp is supported
MAILER_SMTP_HOSTyes-Hostname of the SMTP server
MAILER_SMTP_PORT587Port of the SMTP server
MAILER_SMTP_USERyes-Username for the SMTP server
MAILER_SMTP_PASSWORDyes-Password for the SMTP server

hCaptcha

Keila uses hCaptcha to protect your sign-up forms. Configure hCaptcha with the following variables:

VariableRequiredDefaultDescription
HCAPTCHA_SITE_KEY-hCaptcha site key
HCAPTCHA_SECRET_KEYhttphCaptcha secret key
HCAPTCHA_URLhttps://hcaptcha.com/siteverifyhCaptcha verification URL