Skip to content
Docs

Umami

Install Umami in one click: simple, private website visits, without cookies. What it makes, its admin page, first steps and updates.

Updated 28 Oct 20262 min read

Umami: simple, private website visits, without cookies. It comes from its makers' official release, at an exact version, checked for known security problems and tried on a real server before we offered it.

What it makes

  • The app, with 512 MB of memory and half a processor: the limits it runs well with. They're ceilings, not sizes: it pays only for what it really uses, and you can change them on the install page or later. See limits.

  • Its own PostgreSQL database (512 MB and half a processor), made and connected by itself, with its password kept for you.

  • A free address with HTTPS, and the project's backups, with a first one as soon as it's ready.

Umami starts with a default login; the install changes it to your email and the new password before anyone can reach the app, so the default never works.

Install it

Asha wants Umami in her project duka.

  1. Open the project. On its Overview, under Add a service, choose From the catalog.

  2. Search for Umami, or pick it under its category, then choose Install.

  3. Give it an App name, like visits, and type the Admin email you'll log in with.

  4. Check its limits and the monthly estimate, then choose Install.

A strong password is shown once. Copy it, then choose I've saved it. The app's card shows each step until Ready; until then nobody but you can reach it.

Its admin page

When it's ready, choose Open its admin page on its card: its address followed by /login. Log in with your email and the password you saved, then:

  1. Choose Settings → Websites → Add website and type your site's domain.

  2. Copy the tracking code it shows into your site's pages.

  3. Open Dashboard to see your visits as they come in.

Updates

When a newer, checked version of the same line is out, the app's card shows Update to that version. The project is backed up first; if the new version doesn't start, the one before keeps serving. Security updates install by themselves unless you switch that off on the card, and for 7 days after an update you can Go back to the version before. A new line, like Umami 2 to 3, is a new install, never an update. If the version you run is found to have a known security hole, you get one email and a message under the bell, with Update on the card. See one-click apps.

Licence

Umami is made by its makers, not by us, and keeps its own licence: MIT. Its website: umami.is.

PreviousThe settings file, tanzahost.jsonNextApp settings