3

Systemd Unit File

Louis Lam edited this page 2025-05-19 18:40:15 +08:00

Aside from the provided pm2 instructions. You can also use systemd to enable and run Uptime-Kuma at system startup more easily.

[Unit]
Description=Uptime-Kuma - A free and open source uptime monitoring solution
Documentation=https://github.com/louislam/uptime-kuma
After=network.target

[Service]
Type=simple
User=uptime
WorkingDirectory=/home/uptime/uptime-kuma
ExecStart=/usr/bin/npm run start-server
Restart=on-failure

[Install]
WantedBy=multi-user.target

Note

This unit file assumes that you are running the software as a separate 'uptime' user. If you have node/npm installed in a different path, you will need to alter the ExecStart line to match this.

This unit file may be installed to /etc/systemd/system/uptime-kuma.service (Or whatever service name you'd prefer)

Once installed, issue the following commands to reload systemd unit files, enable it to start on boot, and start it immediately:

systemctl daemon-reload
systemctl enable --now uptime-kuma

• Home
• Troubleshooting

Installation & Configuration

• 🔧 How to Install
• 🆙 How to Update
• Environment Variables
• (Beta) Migration from v1 to v2

Features

• Reset Password via CLI
• Status Page
• Notification Methods
• Badge
• How to Monitor Docker Containers
• Maintenance
• 3rd Party Addons/Apps
• API Keys

Network

• Reverse Proxy
• Reverse Proxy with Cloudflare Tunnel
• Cloudflare Side Note

Integrations

• Prometheus Integration
• Systemd Unit File
• OpenRC Script

Development & Contributions

• CONTRIBUTING Rules & Guide
• How to Translate
• Setup Development Environment
• Test Pull Requests
• Development Side Notes
• API Documentation

More

• Supported Versions
• MIT License
• Videos By Youtubers

Edit this page