DocumentationLogChimp Documentation

Environment Variables

All environment variables used in the LogChimp.

Deployment with one-click deploy buttons by-default pre-fills most of the environment variables during the deployment process; only a few of the environment variables need to be configured manually, such as secret credentials.

Tip

Configuring your LogChimp site is a one-time task and is not required to be updated frequently, unless you're rotating your secret credentials.

Remember to restart the instance after making changes to ensure they take effect.

General

VariableDescriptionDefault value
LOGCHIMP_SECRET_KEYSecret key used for various cryptographic operations like session handling, token generation. Should be long, random string.
LOGCHIMP_MACHINE_SIGNATUREUnique identifier for your instance, used for licensing and authentication.
LOGCHIMP_PROTOCOLProtocol to be used, either http or https.http

API

VariableDescriptionDefault value
API_PORT8000
NODE_ENVproduction
LOGCHIMP_WEB_URLThe complete base URL for the web application including protocol.http://localhost:3000
LOGCHIMP_IS_SELF_HOSTEDtrue

Theme

VariableDescriptionDefault value
NODE_ENVproduction
THEME_PORT3000
LOGCHIMP_API_URLThe complete base URL at which the backend is running on.http://localhost:8000
VITE_IS_SELF_HOSTEDtrue

Database

VariableDescriptionDefault value
LOGCHIMP_DB_HOSTHostname or IP address of your PostgreSQL server.db
LOGCHIMP_DB_DATABASEName of the PostgreSQL database LogChimp will use.logchimp
LOGCHIMP_DB_PORTTCP port your PostgreSQL server is listening on.5432
LOGCHIMP_DB_USERUsername for PostgreSQL authentication.logchimp
LOGCHIMP_DB_PASSWORDPassword for PostgreSQL authentication. Critical: Use a strong, unique password here.logchimp

Mail

You will need to set-up SMTP configuration to let your users get emails to reset password, account verification, notifications and more.

VariableDescriptionDefault value
LOGCHIMP_MAIL_HOSTThe address of your SMTP server.
LOGCHIMP_MAIL_USERSpecify the username for the SMTP configuration here.
LOGCHIMP_MAIL_PASSWORDSpecify the password for the SMTP configuration here.
LOGCHIMP_MAIL_PORTThe port for outgoing emails.587