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.

CLIENT_IP_HEADER = <header name>

HTTP header to check for the client's IP address. This is useful when you're behind a proxy that uses non-standard headers.


Disables the login page for the application.


Removes the trailing slash from all incoming urls.

TRACKER_SCRIPT_NAME = <script name>

Allow you to assign a custom name to the tracker script. The default is umami. If you update this, be sure to update the tracking code on your website to the new name.


Disable collection of completely anonymous telemetry data during installation.

When building a custom image

Required docker build arguments.

BASE_PATH = <path>

(optional) If you want to host Umami under a subdirectory. Only used to prefix URLs at frontend. May need to use reverse proxy to remove BASE_PATH prefix and pass modified URL to umami

DATABASE_TYPE = postgresql | mysql

(required) The type of the DB to be used.