Environment variables

Besides the required DATABASE_URL and HASH_SALT variables in your .env file, you can configure Umami with some additional variables.

IGNORE_IP = <ip addresses>

You can provide a comma-delimited list of IP address to exclude from data collection.

FORCE_SSL = 1

This will redirect all requests from http to https in the Umami application. Note, this does not apply to the tracking script.

LOG_QUERY = 1

If you are running in development mode, this will log database queries to the console for debugging.

HOSTNAME = <hostname>

PORT = <port number>

If you are running on an environment which requires you to bind to a specific hostname or port, such as Heroku, you can add these variables and start your app with npm run start-env instead of npm start.

BASE_PATH = <path>

If you want to host Umami under a subdirectory of domain.