Running on DigitalOcean

DigitalOcean is an affordable cloud hosting provider that will let you host your own Umami setup. In this setup guide we are going to install Ubuntu, a PostgreSQL database, an Nginx web server, Node.js and Umami. DigitalOcean also has a Node.js droplet build that comes with Node.js, Ubuntu and Nginx which can get you started quicker.

For personal use, you can start with a single $5 a month cloud server and scale up as needed. You can use this link to get a $100 credit for the first 60 days.

Note, these steps can be repeated on any cloud hosting provider that offers Ubuntu.

Install Ubuntu#

• Initial server setup with Ubuntu 20.04

Install PostgreSQL#

• How to install PostgreSQL on Ubuntu 20.04

Install Nginx#

• How to install Nginx on Ubuntu 20.04

Install Node.js#

• How to install Node.js on Ubuntu 20.04

Install Umami#

• See Install under Quickstart

Running Umami#

You can simply run pnpm start to start Umami, but it's highly recommended you use a process manager like PM2 which will handle restarts for you.

To run with PM2:

pnpm add -g pm2
cd umami
pm2 start "pnpm start" --name umami
pm2 startup
pm2 save

Proxying with Nginx#

With Umami now running, you can proxy requests to a domain or subdomain from Nginx to Umami.

The following config will send all requests from umami.yourdomain.com to your local Umami instance.

server {
  server_name umami.yourdomain.com;

  location / {
    proxy_pass http://localhost:3000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

The following config will allow you to host Umami at a subpath for your domain (e.g. website.com/stats). This requires setting the environment variable BASE_PATH=/stats in your .env file. BASE_PATH is a build-time variable, so you need to rebuild Umami with pnpm build after setting it.

server {
  ...
  location /stats/_next/static/ {
    alias /your_install_location/umami/.next/static/;
    access_log off;
    expires max;
  }
  location /stats {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
  ...
}

Adding an SSL certificate (optional)#

• How To Secure Nginx with Let's Encrypt on Ubuntu 20.04

Finish#

That's it! You're now self-hosting Umami on your own server.