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.

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.

DISABLE_LOGIN = 1

Disables the login page for the application.

REMOVE_TRAILING_SLASH = 1

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_TELEMETRY = 1

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.