Umami (Self-Hosted Analytics)

This document explains how Umami Analytics is deployed, accessed, and managed when installed as a One-Click App on FlyWP.

What is Umami

Umami is a lightweight, privacy-focused, open-source web analytics platform. It provides essential website analytics without cookies, trackers, or invasive user profiling.

FlyWP offers Umami as a one-click deployment, handling installation, database setup, web server configuration, and SSL automatically.

Your Umami installation will create a default administrator account with the username admin and the password umami.

Deployment Overview

When you deploy Umami from:

Create Site → Deploy One Click App → Umami

FlyWP automatically:

• Provisions Umami on the selected server
• Sets up the required database
• Assigns a FlyWP subdomain (or your custom domain)
• Configures NGINX and SSL
• Creates initial admin credentials

No manual Docker, Node.js, or database setup is required.

Default Access URLs

After deployment, Umami exposes a single web interface:

• Umami Dashboard
  https://<your-domain>/

This dashboard is used for both administration and analytics.

Default Login Credentials

After installation, FlyWP generates Umami admin credentials automatically.

• Username: admin
• Password: Available in the FlyWP dashboard (Site details / Environment section)

You should change the admin password immediately after first login.

Environment Variables

Umami configuration is primarily controlled through environment variables. These are available at:

Site → Environment

Common Variables

DATABASE_URL=<auto-generated>
APP_SECRET=<generated-secret>
BASE_URL=https://your-domain

Variable Explanation

• DATABASE_URL
  Connection string for the Umami database. Managed automatically by FlyWP.
• APP_SECRET
  Used to sign sessions and secure authentication.
• BASE_URL
  Public URL of your Umami instance. Must match the site domain and protocol.

After modifying any environment variables, click Update Environment and restart the service if required.

First Login & Setup

1. Visit:https://<your-domain>
2. Log in using the admin credentials
3. Navigate to Settings → Websites
4. Add your website(s)
5. Copy the tracking script provided by Umami
6. Insert the script into your website header or via a tag manager

Privacy & Compliance

Umami is designed to be privacy-first by default:

• No cookies
• No personal data collection
• GDPR and CCPA friendly

This makes Umami suitable for sites that want analytics without cookie banners or consent popups.

Managing Umami from FlyWP

From the FlyWP dashboard you can:

• Manage → Restart, stop, or redeploy Umami
• Logs → View application and database logs
• NGINX Config → Add headers or reverse-proxy rules (advanced use only)

SSL & Security

• SSL is enabled automatically
• HTTPS is enforced when supported
• Authentication is required for all dashboard access

Security Recommendations

• Change the default admin password immediately
• Use a custom domain instead of the FlyWP subdomain
• Restrict server access via firewall rules if needed
• Rotate APP_SECRET only if sessions need to be invalidated

Backups & Data Safety

Umami stores analytics data in its database.

Recommended backup strategies:

• Enable FlyWP server-level backups
• Periodically export analytics data if required

Always test restores before relying on backups in production.

Troubleshooting

Cannot Log In

• Verify admin credentials
• Check logs for database or auth errors
• Ensure BASE_URL matches the actual site URL

Tracking Not Working

• Confirm tracking script is installed correctly
• Check ad blockers or CSP headers
• Verify the website domain matches Umami configuration

Dashboard Not Loading

• Restart the service from FlyWP
• Check application logs
• Confirm SSL and domain configuration

When to Use Umami on FlyWP

Umami One-Click App is ideal for:

• Privacy-focused websites
• SaaS dashboards and internal tools
• Personal blogs and company sites
• GDPR-conscious environments

Not intended for advanced behavioral tracking or ad attribution.

Summary

FlyWP’s Umami One-Click App provides:

• Fast, zero-config deployment
• Privacy-first analytics
• Low resource usage
• Simple, clean dashboard

It is a strong alternative to Google Analytics for users who want control, compliance, and simplicity.