Choose a Deployment Method
Compare the support status of each deployment method and how configuration changes apply, then select one.
Before you deploy
- Get the full URL of an Uptime Kuma status page, for example
https://example.kuma-mieru.invalid/status/default. - Set the Uptime Kuma display time zone to UTC+0.
For the procedure, see Connect Uptime Kuma.
Deployment methods
Vercel
Recommended. Fork the repository and import it in the browser. You need no server.
Netlify
Deploy with the Deploy button or import your fork.
EdgeOne Pages
Import your fork and select the Next.js framework preset.
Cloudflare Workers
Not supported yet. Describes the Cloudflare configuration in the repository.
Docker
Beta. Run the GHCR image on your own server.
Run from source
Start a development server or build a production version with Bun.
Platform root directory
The repository is a monorepo, and the web application is in apps/web. When you import the repository on Vercel, EdgeOne Pages or Cloudflare, set the project root directory (Root Directory) to apps/web. On Netlify, set Package directory to apps/web; see Netlify. The platform configuration files vercel.json, netlify.toml, edgeone.json and wrangler.jsonc are in this directory.
When the configuration applies
The web application generates its configuration with the generate script. The script reads the environment variables, requests each status page to get its title, description and icon, and writes the result to apps/web/config/generated-config.json. Each deployment method runs this script at a different time. Thus the action after you change an environment variable is also different.
| Deployment method | Configuration is generated | After you change a variable |
|---|---|---|
| Vercel, Netlify, EdgeOne Pages | During the platform build | Redeploy |
| Docker | When the container starts | Recreate the container |
| Run from source | When you run bun run dev, bun run build or bun run start | Run the command again |
Some variables apply at a different time. See Environment Variables.
Last updated on