# Umami (Self-Hosted Analytics)

Source: https://flywp.com/docs/one-click-apps/umami/

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 <em>**admin**</em> and the password <em>**umami**</em>.

## 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

```bash
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.