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.


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


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.