---
title: "Deploy Umami on StackBlaze"
description: "Deploy Umami with managed Postgres and a public HTTPS URL. Add a website, paste one script tag, and watch visitors, pageviews and events arrive in real time. The admin password is generated at deploy, so the default login never goes live."
category: "data, utilities"
url: https://www.stackblaze.com/templates/umami
---

# Deploy Umami

Deploy Umami with managed Postgres and a public HTTPS URL. Add a website, paste one script tag, and watch visitors, pageviews and events arrive in real time. The admin password is generated at deploy, so the default login never goes live.

**[Deploy Umami on StackBlaze](https://dashboard.stackblaze.com/new/template/umami)**

## This stack

- **Umami**: Web service
- **PostgreSQL**: managed database · TCP:5432

## What you get

- **Traffic at a glance**: Visitors, visits, views, bounce rate and visit duration for any date range, with pages, sources, devices and locations underneath.
- **Realtime view**: See who is on your site right now: live pageviews, custom events and the pages they land on, updated as they happen.
- **Events and goals**: Track clicks and signups with a data attribute or the JavaScript API, then build funnels, goals, journeys and retention reports on them.
- **No cookies**: The tracker sets no cookies and stores no IP addresses. Visitors are counted with a salted hash that rotates every month.
- **One script tag**: Each website gets a snippet that loads script.js from your own hostname. Rename the script if ad blockers get in the way.
- **Teams and users**: Add users, group websites into teams, share a read only dashboard link, and turn on two-factor login per user.

## After you deploy

1. **Sign in as admin**: Open the public URL and sign in as admin with ADMIN_PASSWORD from the app’s Variables. The first start runs the database migrations in about a minute.
2. **Add your website**: Go to Settings, then Websites, and add your site’s name and domain. Umami gives it a website ID.
3. **Paste the tracking code**: Copy the script tag from the website’s Tracking code and put it in your site’s head. Visits show up in Realtime within seconds.

## How it is wired

- **Postgres holds everything**: Websites, users, sessions and every event live in the attached database. Migrations run on each start, so updates apply themselves.
- **No default password**: Umami ships with admin and a well known password. This template replaces it with a generated one before the app serves its first request.
- **Visitor locations**: Countries and cities come from a GeoIP database inside the image, looked up from the visitor’s real address. Visitors cannot fake them with headers.
- **Keep the app secret**: APP_SECRET signs logins and goes into every visitor hash. It is generated once at deploy. Changing it signs everyone out and splits visitor counts.

## Common questions

### How do I sign in after deploy?

Open the public URL and sign in as admin. The password is generated at deploy and shown as ADMIN_PASSWORD in the app’s Variables. It replaces the default only once, so change it later in your Umami profile.

### How do I add tracking to my site?

Add a website in Settings, open it, and copy the script tag under Tracking code into your site’s head. It loads script.js from your Umami hostname.

### Ad blockers block script.js. Can I rename it?

Yes. Set TRACKER_SCRIPT_NAME (for example stats.js) and COLLECT_API_ENDPOINT (for example /api/collect) in Variables, then update the snippet on your site.

### Does it use cookies?

No. The tracker sets no cookies and Umami does not store IP addresses. Unique visitors are counted with a salted hash that rotates every month.

### Can I use my own domain?

Yes. Attach a custom domain from the dashboard, then use it in your tracking snippet. A first party domain also helps with ad blockers.

### Can I turn on two-factor login?

Yes. Each user can enable it under their profile. The encryption key for two-factor secrets is generated at deploy.

### What does it cost?

You pay for the compute, storage and bandwidth Umami and Postgres use, not per pageview, per website or per seat.


Source: https://github.com/umami-software/umami