Unlatch GitHub

Configuration

Unlatch reads its configuration from environment variables when it starts.

VariableDefaultMeaning
UNLATCH_ISSUERrequiredThe address people open, such as https://login.example.com. Every URL Unlatch sends is built from it. Plain http is accepted only on localhost, for trying Unlatch out.
UNLATCH_KEY_FILErequiredA file with the master key, which encrypts the secrets in the database; see the master key.
UNLATCH_LISTEN127.0.0.1:8080The address and port to listen on.
UNLATCH_DATABASEunlatch.dbThe SQLite file. It is created if it doesn't exist.
UNLATCH_TRUSTED_PROXIESnoneAddresses or networks of your reverse proxies, separated by commas, such as 127.0.0.1, 10.0.0.0/8. X-Forwarded-For is believed only from these.
UNLATCH_LOGinfoerror, warn or info.
UNLATCH_TLS_CERT, UNLATCH_TLS_KEYnonePEM files of a certificate chain and its key, to serve https without a reverse proxy. Unlatch reads them again within a minute of a change, so renewals need no restart.