Umami on Edge, one VM for every site you track

1. 01

   Create a Docker VM

   The docker library script installs Docker CE and Compose on first boot.

   shellCopy

   $ edge compute create --name umami --size s-2vcpu-4gb \
       --image ubuntu-24 --region london --script docker

2. 02

   Write the compose file

   Keep DB_PASSWORD and APP_SECRET in a .env file next to it. Umami creates its tables on first start.

   docker-compose.ymlCopy

   services:
     umami:
       image: ghcr.io/umami-software/umami:postgresql-latest
       ports: ["127.0.0.1:3000:3000"]
       environment:
         DATABASE_URL: postgresql://umami:${DB_PASSWORD}@db:5432/umami
         APP_SECRET: ${APP_SECRET}
       depends_on: [db]
       restart: always
     db:
       image: postgres:16-alpine
       environment:
         POSTGRES_DB: umami
         POSTGRES_USER: umami
         POSTGRES_PASSWORD: ${DB_PASSWORD}
       volumes: ["umami-db:/var/lib/postgresql/data"]
       restart: always
   volumes:
     umami-db:

3. 03

   Start it and put the CDN in front

   Proxy :443 on the VM to port 3000. Then sign in as admin / umami and change the password straight away.

   shellCopy

   $ docker compose up -d
   $ edge cdn create --name umami
   $ edge cdn domains add cdn-a1b2c3 \
       --domain stats.acme.com \
       --origin https://<vm-ip>

4. 04

   Track your sites

   Add each website in the dashboard to get its ID, then add the tag. Custom events are one call.

   index.htmlCopy

   <script defer src="https://stats.acme.com/script.js"
     data-website-id="94db1cb1-74f4-4a40-ad6c-962362670409"></script>
   
   <script>
     // custom event with properties
     umami.track('signup', { plan: 'pro' })
   </script>

Prefer to hand it off? Give the job to your AI agent or have our engineers do it.