"use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; function _createMdxContent(props) { const _components = { a: "a", code: "code", h2: "h2", hr: "hr", p: "p", strong: "strong", ...props.components }; return _jsxs(_Fragment, { children: [_jsxs(_components.p, { children: ["You can configure Umami with the use of environment variables. They go into the same ", _jsx(_components.code, { children: ".env" }), " file as your ", _jsx(_components.code, { children: "DATABASE_URL" }), "."] }), "\n", _jsx(_components.hr, {}), "\n", _jsx(_components.h2, { id: "runtime-variables", children: "Runtime variables" }), "\n", _jsx(_components.p, { children: "Runtime variables are recognized when Umami is running. You can set your environment variables prior to starting the application." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "APP_SECRET = " }) }), "\n", _jsx(_components.p, { children: "A unique value for your installation." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "CLIENT_IP_HEADER =

" }) }), "\n", _jsx(_components.p, { children: "HTTP header to check for the client's IP address. This is useful when you're\nbehind a proxy that uses non-standard headers." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "CLOUD_MODE = 1" }) }), "\n", _jsxs(_components.p, { children: ["Disables ", _jsx(_components.code, { children: "users" }), ", ", _jsx(_components.code, { children: "teams" }), ", and ", _jsx(_components.code, { children: "websites" }), " settings page."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "COLLECT_API_ENDPOINT = " }) }), "\n", _jsxs(_components.p, { children: ["Allows you to send metrics to a location different than the default ", _jsx(_components.code, { children: "/api/send" }), ". This is to help you avoid some ", _jsx(_components.a, { href: "/docs/bypass-ad-blockers", children: "ad blockers" }), "."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "CORS_MAX_AGE = " }) }), "\n", _jsx(_components.p, { children: "How many seconds a CORS preflight should last. Default is 24 hours." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "DATABASE_URL = " }) }), "\n", _jsx(_components.p, { children: "Connection string for your database. This is the only required variable." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "DEBUG = " }) }), "\n", _jsxs(_components.p, { children: ["Console logging for specific areas of the application. Values include ", _jsx(_components.code, { children: "umami:auth" }), ", ", _jsx(_components.code, { children: "umami:clickhouse" }), ", ", _jsx(_components.code, { children: "umami:kafka" }), ", ", _jsx(_components.code, { children: "umami:middleware" }), ", and ", _jsx(_components.code, { children: "umami:prisma" }), "."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "DISABLE_BOT_CHECK = 1" }) }), "\n", _jsx(_components.p, { children: "By default bots are excluded from statistics. This disables checking for bots." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "DISABLE_LOGIN = 1" }) }), "\n", _jsx(_components.p, { children: "Disables the login page for the application." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "DISABLE_UPDATES = 1" }) }), "\n", _jsx(_components.p, { children: "Disables the check for new versions of Umami." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "DISABLE_TELEMETRY = 1" }) }), "\n", _jsx(_components.p, { children: "Umami collects completely anonymous telemetry data in order help improve the application. You can choose to disable this if you don't want to participate." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "ENABLE_TEST_CONSOLE = 1" }) }), "\n", _jsxs(_components.p, { children: ["Enables the internal test page, ", _jsx(_components.code, { children: "{host}/console" }), ". Admin access is required. Users can manually fire pageviews and events to their websites."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "HOSTNAME = " }), " / ", _jsx(_components.strong, { children: "PORT = " })] }), "\n", _jsxs(_components.p, { children: ["If you are running on an environment which requires you to bind to a specific hostname or port, such as Heroku, you can add\nthese variables and start your app with ", _jsx(_components.code, { children: "npm run start-env" }), " instead of ", _jsx(_components.code, { children: "npm start" }), "."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "IGNORE_IP = " }) }), "\n", _jsx(_components.p, { children: "You can provide a comma-delimited list of IP addresses and ranges to exclude from data collection." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "LOG_QUERY = 1" }) }), "\n", _jsx(_components.p, { children: "If you are running in development mode, this will log database queries to the console for debugging." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "PRIVATE_MODE = 1" }) }), "\n", _jsx(_components.p, { children: "Disables all external network calls. Note, this will also disable all website icons since they come from duckduckgo.com." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "REMOVE_TRAILING_SLASH = 1" }) }), "\n", _jsx(_components.p, { children: "Removes the trailing slash from all incoming urls." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "TRACKER_SCRIPT_NAME =