Page:
Environment Variables
Pages
3rd Party Addons Apps
API Keys
Badge
Cloudflare Side Note
Development Side Notes
Environment Variables
Home
How to Monitor Docker Containers
Maintenance
Migration From v1 To v2
Notification Methods
OpenRC Script
Prometheus Integration
Reset Password via CLI
Reverse Proxy with Cloudflare Tunnel
Reverse Proxy
Setup Development Environment
Status Page
Systemd Unit File
Test Pull Requests
Troubleshooting
_Menu
🆙 How to Update
🔧 How to Install
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 |
Installation & Configuration
Features
- Reset Password via CLI
- Status Page
- Notification Methods
- Badge
- How to Monitor Docker Containers
- Maintenance
- 3rd Party Addons/Apps
- API Keys
Network
Integrations
Development & Contributions
- CONTRIBUTING Rules & Guide
- How to Translate
- Setup Development Environment
- Test Pull Requests
- Development Side Notes