Running on Fly.io

Fly.io turns containers into VMs that can be deployed in one or multiple regions. The fly launch process can automatically set up a PostgreSQL VM connected to your Umami app.

Set up using Umami's prebuilt container#

For anyone wishing to deploy Umami on Fly now, here's a simple method using Umami's prebuilt container instead of pulling the source and modifying the Dockerfile.

If you don't already have flyctl installed, install it.

1. In a new directory for your app, create fly.toml:

kill_signal = "SIGINT"
kill_timeout = "5s"

[experimental]
auto_rollback = true

[build]
image = "docker.umami.is/umami-software/umami:latest"

[[services]]
protocol = "tcp"
internal_port = 3000
processes = ["app"]

[[services.ports]]
port = 80
handlers = ["http"]
force_https = true

[[services.ports]]
port = 443
handlers = ["tls", "http"]

[services.concurrency]
type = "connections"
hard_limit = 25
soft_limit = 20

[[services.tcp_checks]]
interval = "15s"
timeout = "2s"
grace_period = "1s"

2. Run fly launch and choose to create an app with the found fly.toml configuration.
3. Go through the launch steps, and choose y on the step to create a connected PostgreSQL app.
4. Choose not to deploy the app yet.
5. Run fly secrets set APP_SECRET="<random-string>", replacing <random-string> (including the angle brackets) with a random string used to secure authentication tokens.
6. Run fly deploy. There will be errors, but let the deployment complete.
7. Run fly scale memory 512. Umami may fail with less than 512 MB of RAM, so increase this if needed.
8. Run fly deploy.
9. Following the Login docs, log in with username admin and password umami, then change the default password.

Adjust instance locations, number of machines, auto-scaling, custom domains for your Umami app, and any other Fly.io options as per the Fly.io docs.