24 Environment Variables
Michael Fernandes edited this page 2024-11-20 04:36:13 -03:00

(1.20.0) For non-Docker users, you can create a new file named .env in the root directory. The format is like this:

UPTIME_KUMA_HOST=127.0.0.1
UPTIME_KUMA_PORT=8080

Server Argument Usage:

node server/server.js --host=127.0.0.1 --port=8080

Server Environment Variables

Environment Variable Server Argument Description Default
DATA_DIR --data-dir= Set the directory where the data should be stored (could be relative) ./data/
UPTIME_KUMA_HOST or HOST --host= Host to bind to, could be an ip. ::
UPTIME_KUMA_PORT or PORT --port= Port to listen to 3001
UPTIME_KUMA_SSL_KEY or SSL_KEY --ssl-key= Path to SSL key
UPTIME_KUMA_SSL_CERT or SSL_CERT --ssl-cert= Path to SSL certificate
UPTIME_KUMA_SSL_KEY_PASSPHRASE or SSL_KEY_PASSPHRASE --ssl-key-passphrase= (1.21.1) SSL Key Passphrase
UPTIME_KUMA_CLOUDFLARED_TOKEN --cloudflared-token= (1.14.0) Cloudflare Tunnel Token
UPTIME_KUMA_DISABLE_FRAME_SAMEORIGIN --disable-frame-sameorigin= By default, Uptime Kuma is not allowed in iframe if the domain name is not the same as the parent. It protects your Uptime Kuma to be a phishing website. If you don't need this protection, you can set it to true false
UPTIME_KUMA_WS_ORIGIN_CHECK By default, Uptime Kuma is verifying that the websockets ORIGIN-Header matches your servers hostname. If you don't need this protection, you can set it to bypass. See GHSA-mj22-23ff-2hrr for further context. cors-like
UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC --allow-all-chrome-exec= (1.23.0) Allow to specify any executables as Chromium 0
NODE_EXTRA_CA_CERTS Add your self-signed ca certs. (e.g. /cert/path/CAcert.pem) Read more
NODE_TLS_REJECT_UNAUTHORIZED Ignore all TLS errors 0
NODE_OPTIONS Set it to --insecure-http-parser, if you encountered error Invalid header value char when your website using WAF

Docker Specific Environment Variables

Environment Variable Description Default
PUID User id to access the data storage 1000
PGID Group id to access the data storage 1000

For Development only

Environment variable Server argument Description Default
NODE_ENV Set the NodeJS environment flag. development, production production
UPTIME_KUMA_LOG_RESPONSE_BODY_MONITOR_ID Monitor ID - If provided, it will output the monitor's response to your console
UPTIME_KUMA_HIDE_LOG (1.15.0) Examples: debug_monitor,info_monitor,debug_cert,warn_monitor
SQL_LOG Set 1 to enable
UPTIME_KUMA_ENABLE_EMBEDDED_MARIADB (2.0.0) Set 1 to enable
UPTIME_KUMA_IN_CONTAINER (1.23.0) Is Uptime Kuma inside a container?

MariaDB Environment Variables

Environment Variable Description
UPTIME_KUMA_DB_TYPE Database Type sqlite, mariadb
UPTIME_KUMA_DB_HOSTNAME Database hostname. for mariadb
UPTIME_KUMA_DB_PORT Database port. for mariadb, 3306
UPTIME_KUMA_DB_NAME Database name
UPTIME_KUMA_DB_USERNAME Database username
UPTIME_KUMA_DB_PASSWORD Database password