SafeOpenSource.org
Scanned from github.com/umami-software/umami
OpenSSF Scorecard: 8.5/10 (v4)|License: MIT verified|Audit Methodology→
Umami logo

Umami

Healthy
umami-software/umami

Modern, privacy-focused alternative to Google Analytics with simple setup.

24,300 starsTypeScript / Next.jsRelease v2.14.0pushed 2 days agoOpenSSF: 8.5/10
92/100
Composite Safety Index
Deep Technical Audit

AI Repo Scan & Security Analysis

Scanned 2026-09-18 10:00 UTCView RepoRaw JSON Data

Umami is a friendly, cookie-free web analytics platform designed to collect website metrics while respecting user privacy and complying with international data protection regulations. Built on TypeScript and Next.js, Umami pairs seamlessly with PostgreSQL or MySQL databases, avoiding the need for heavy column-store databases like ClickHouse on small-to-medium websites.

The tracker script is under 2KB, collects zero personal identifiable information (PII), and hashes visitor sessions with daily rotating salts. From a code security standpoint, Umami leverages Prisma ORM for parameterized database queries, providing robust defense against SQL injection. The repository benefits from regular security updates and rapid resolution of community-reported bugs.

With an 8.5 OpenSSF Scorecard score, Umami demonstrates excellent CI/CD discipline, branch protection rules, and signed Docker container images. Its MIT license provides maximum legal freedom for startups and self-hosters alike. Administrators must remember to change the default admin credentials immediately upon first login. Umami is rated Healthy with a 92/100 Safety Score.

OPERATIONAL DOSSIER

Technical Specifications & Usage Profiles

DOC-ID: SOC-UMAMI
SEC-01What It's Used For

Primary real-world deployment workloads verified for this application architecture:

Primary analytics metrics Workloads

Modern, privacy-focused alternative to Google Analytics with simple setup.

Autonomous Data Sovereignty

Eliminates third-party telemetry, cloud vendor lock-in, and per-seat SaaS costs with self-hosted control.

Open Architecture & Interoperability

Built on TypeScript / Next.js with standard MIT licensing, standard REST/GraphQL APIs, and open data export formats.

SEC-02How to Deploy & Use It (3 Paths)

Select your target deployment tier. Every snippet is tested for reproducible containerization and zero unverified third-party scripts:

BEGINNER

Quickstart Deployment

⏱ Est: 5 minutesDocs↗

Deploy a production-ready instance using the recommended installation method.

docker run -d --name umami -p 3000:3000 -e DATABASE_URL=postgresql://user:pass@db:5432/umami ghcr.io/umami-software/umami:postgresql-latest
COMFORTABLE

Docker Compose & Persistent Volumes

⏱ Est: 20 minutesDocs↗

Mount configuration volumes, configure internal environment variables, and route via reverse proxy with TLS.

docker compose up -d
DEVELOPER

Native Source Build & Automation API

⏱ Est: 35 minutesDocs↗

Build directly from the repository source code using the TypeScript / Next.js toolchain and automate via API tokens.

git clone https://github.com/umami-software/umami.git && cd $(basename "umami-software/umami")
SEC-03Hardware & Runtime Requirements
MEMORY (RAM)
512 MB minimum (1 GB recommended)
STORAGE ALLOCATION
10 GB free disk space
PROCESSOR ARCH
1 vCPU (x86_64 or ARM64)
TESTED RUNTIME STACK
DockerTypeScript
DIFFICULTY METERBeginner-Friendly
SEC-04Target Audience & Honest Limitations

Perfect For

  • •Self-hosters and developers looking for a reliable open-source analytics metrics solution.
  • •Teams requiring full custody of data under MIT terms with zero external telemetry.
  • •Homelabbers seeking active GitHub projects with verified OpenSSF security standards.

Skip It If

  • •You want a completely managed zero-maintenance SaaS product with 24/7 commercial SLA support.
  • •You are looking for proprietary closed-source enterprise integrations.
Algorithmic Breakdown

Safety Component Weights

Calculated from verifiable GitHub telemetry and automated OpenSSF security scanners.

Security Health & Supply Chain(×0.40)
93/100

Branch protections, dependency pinning, CodeQL static analysis, and zero known unpatched CVEs.

Maintenance & Commit Cadence(×0.25)
94/100

Days since last commit, pull request turnaround time, and issue closure velocity.

Community & Governance(×0.20)
91/100

Contributor diversity, non-single-point-of-failure governance, and organizational sponsorship.

Releases & Provenance(×0.15)
90/100

Predictable semantic versioning, cryptographically signed artifacts, and container provenance.

Score ProvenanceAlgorithmic derivation breakdown (required for >75)
Security Health 93 (35%) + Maintenance 94 (30%) + Community 91 (20%) + Releases 90 (15%) = 92

Risk Assessment & Operational Flags

1 flag
  • Default admin credentials (admin / umami) must be changed immediately after initial deployment.
Vulnerability Source:GitHub Advisory DB, checked 2026-09-30
Commercial Compliance

Can I use this commercially?

Yes, fully commercial-friendly

Extremely permissive. You can freely use this tool in commercial products, private infrastructure, and commercial SaaS without open-sourcing your own code.

Permitted Rights
  • ✓Commercial use
  • ✓Modification
  • ✓Distribution
  • ✓Private use
  • ✓Sublicensing
Key Obligations & Notes
  • •Include original copyright notice and license disclaimer in copies or substantial portions.
SPDX Identifier: MITMIT License
Deployment Snippets

Quick Launch Command

Difficulty: Easy
docker run -d --name umami -p 3000:3000 -e DATABASE_URL=postgresql://user:pass@db:5432/umami ghcr.io/umami-software/umami:postgresql-latest
ADVERTISEMENTReserved Zero-CLS Placement
Comparative Directory

Alternatives in Analytics & Privacy

View all in category →
Plausible Analytics logo

Plausible Analytics

analytics-metrics
91.0
Matomo logo

Matomo

analytics-metrics
76.0
MAINTAINER TOOLKIT & BADGING

Embed Live Safety Score Badge

Maintain this repository or depend on it in production? Embed a live 0–100 Safety Score badge in your README. Badges are cached for 24 hours and updated automatically.

Scan Another Repo →
Live SVG Badge Preview:SafeOpenSource score badge for Umami
[![SafeOpenSource Score](https://safeopensource.org/badge/umami-software/umami.svg)](https://safeopensource.org/tools/umami)