Environment Variables

(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