{"full_name":"umami-software/umami","owner":"umami-software","name":"umami","shard":"1","url":"https://github.com/umami-software/umami","description":"Umami is a privacy-first web and product analytics platform. Traffic, campaigns, behavior, conversions, and revenue in one place. No cookies, no surveillance, self-hosted or in the cloud.","homepage":"https://umami.is","topics":["analytics","charts","statistics","google-analytics","web-analytics","audience-segmentation","cohort-analysis","product-analytics","user-journey"],"tag_pages":["analytics","charts","statistics","web-analytics"],"language":"TypeScript","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/105618662?v=4","created_at":"2020-07-17T07:59:00Z","pushed_at":"2026-11-15T06:35:55Z","metrics":{"stars":40160,"forks":8552,"watchers":135,"issues":2336,"prs":1599,"releases":113,"issues_open":34,"issues_closed":2302,"prs_open":95,"prs_closed":463,"prs_merged":1041,"discussions":778},"growth":{"day":{"stars":15,"forks":4,"base_day":"2026-11-15"},"week":{"stars":154,"forks":45,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-09","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[40006,40034,40063,40089,40095,40120,40145,40160],"forks":[8507,8516,8526,8526,8530,8542,8548,8552],"watchers":[135,135,134,135,135,135,135,135],"issues_open":[null,null,68,41,32,33,33,34],"prs_open":[null,null,87,88,91,91,94,95]},"boards":{},"same_owner":[],"issues":[{"number":3163,"title":"External auth/OIDC","comments":31,"created_at":"2025-01-07T20:30:49Z"},{"number":3518,"title":"Accurate Bounce & Time-on-Site Metrics for Long Single-Page Visits (Heartbeat & Engagement Events Support)","comments":7,"created_at":"2025-07-19T11:54:54Z"},{"number":3267,"title":"Umami breaks client side navigation when paired with anchors. Forces full page reload.","comments":6,"created_at":"2025-02-23T23:04:58Z"},{"number":4448,"title":"Duplicate visitor/session entries when country is Singapore","comments":5,"created_at":"2026-08-13T14:57:44Z"},{"number":4368,"title":"The heatmap is very inaccurate","comments":5,"created_at":"2026-06-30T11:47:39Z"},{"number":4233,"title":"Feature request: Saving filters for a board","comments":5,"created_at":"2026-05-04T11:59:12Z"},{"number":3120,"title":"Allow API to set browser, os, device, country, etc.","comments":4,"created_at":"2024-12-18T18:56:11Z"},{"number":4684,"title":"[Feature Request] Optional WebSocket transport for event collection (self-hosted)","comments":3,"created_at":"2026-10-25T02:41:29Z"}],"discussions":[{"number":4761,"title":"v3.5.0","comments":1,"category":"General","created_at":"2026-11-12T02:57:20Z"},{"number":4754,"title":"Zero analytics by default: an env-gated Umami Cloud script in a client-only Next.js app","comments":0,"category":"Show and tell","created_at":"2026-11-10T02:01:17Z"},{"number":4751,"title":"Self hosted v3.4.1: Umami in the site's existing Postgres, and tracker paths served through the site's own domain?","comments":1,"category":"Q&A","created_at":"2026-11-09T11:59:23Z"},{"number":4728,"title":"Website is down.","comments":0,"category":"General","created_at":"2026-11-02T03:25:56Z"},{"number":4693,"title":"Proposal: a Zapier integration for Umami","comments":0,"category":"Ideas","created_at":"2026-10-26T10:02:38Z"},{"number":4689,"title":"Session replays: filter by rage clicks and dead clicks","comments":0,"category":"Ideas","created_at":"2026-10-25T18:44:33Z"},{"number":4642,"title":"Hash routing + Heatmaps + Performance metrics","comments":1,"category":"Q&A","created_at":"2026-10-19T12:15:56Z"},{"number":4641,"title":"Best way to tell subdomains apart in one website?","comments":1,"category":"Q&A","created_at":"2026-10-19T11:35:27Z"}],"latest_release":{"name":"v3.5.0","tag":"v3.5.0","published_at":"2026-11-12T02:57:20Z","body":"Umami `v3.5.0` adds **browser error tracking**, improved replay navigation, and fixes across tracking, reporting, and sharing.\r\n\r\n## New features\r\n\r\n### Browser error tracking\r\n\r\nCapture JavaScript errors alongside your analytics and investigate affected visits.\r\n\r\n- Automatically capture uncaught exceptions and unhandled promise rejections with `data-errors=\"true\"`\r\n- Capture handled errors with `umami.captureException()`\r\n- Group errors into issues with stack traces, occurrence counts, and session details\r\n- Resolve, ignore, and reopen issues\r\n- Search and filter by release, environment, browser, and page path\r\n\r\n### Replays and navigation\r\n\r\n- Previous/next replay controls with left/right arrow keyboard shortcuts\r\n- Distinct visitor IDs in replay lists\r\n- Team websites available in the website switcher outside a team\r\n- Dashboard access from mobile navigation\r\n\r\n### Tracking and preferences\r\n\r\n- Configure the tracker and recorder through `window.umamiConfig`, with script attributes taking precedence\r\n- Optional client-provided session salts and hourly, daily, weekly, or monthly tracker salt rotation, enabled server-side with `ENABLE_CLIENT_SALT`\r\n- Expanded server-side `SALT_ROTATION` options, including fixed salts\r\n- `TRUSTED_PROXIES` configuration for client IP detection behind multiple proxies\r\n- A 12/24-hour clock preference\r\n\r\n## Reporting improvements\r\n\r\n- Click a website chart bar to zoom into its date range\r\n- Select custom date ranges in a single two-month calendar\r\n- Compare an ongoing period against the equivalent elapsed portion of the previous period\r\n- Improved comparison chart alignment, timezone handling, and daylight-saving transitions\r\n- Retention cell shading relative to the highest visible value\r\n- Session referrers in Session Overview and active visitor indicators in the realtime log\r\n- Faster attribution, funnel, and paginated queries\r\n\r\n## Security\r\n\r\n- Require changing the seeded administrator password before continuing\r\n- Enforce required two-factor enrollment on the server and harden verification against concurrent attempts and code reuse\r\n- Revalidate share tokens against current share settings so deletion and permission changes take effect\r\n- Restrict board shares from exposing raw event, session, revenue, and realtime activity data\r\n- Tighten team permissions, password updates, and API key route checks\r\n- Validate link destinations and collection input more strictly\r\n\r\n## Fixes\r\n\r\n- Session resets, identity attribution, and concurrent anonymous-session claims\r\n- Redis-backed login sessions expiring during active use\r\n- Stale website, link, and pixel caches after updates or deletion\r\n- Background-tab and prerendered-page performance measurements\r\n- Heatmap overlays in Safari, snapshot sizing, and tracking inside preview frames\r\n- Retention cohort dates, full-month navigation, and invalid custom date selections\r\n- Search text being overwritten by delayed navigation\r\n- Custom wildcard selections and missing values in negative filters\r\n- Board ownership when transferring websites\r\n- Docker/Podman server binding\r\n- Translation, accessibility, and responsive layout issues\r\n\r\n## API updates\r\n\r\n- Optional `period` parameters on analytics endpoints, including `today`, `24h`, `7d`, and `30d`\r\n- `visitId` in website event responses\r\n- New error tracking endpoints and refreshed API client types\r\n- Corrected event-filter handling in MCP tools\r\n\r\n## Upgrade notes\r\n\r\n- **`APP_SECRET` must be set explicitly.** Falling back to `DATABASE_URL` is no longer supported.\r\n- Node.js **20.19+** is required; Node.js 22 LTS is recommended.\r\n- Password changes are now under **Settings → Security**.\r\n- The public `/api/config` endpoint has been removed.\r\n\r\nThis release includes database migrations:\r\n\r\n- PostgreSQL: `27_add_error_tracking`\r\n\r\n**Full Changelog:** [v3.4.1…v3.5.0](https://github.com/umami-software/umami/compare/v3.4.1...v3.5.0)\r\n\r\n## Thanks\r\n\r\n@anandghegde @Na5co @SulimanAbdulrazzaq @lidarbtc @4RH1T3CT0R7 @pOwn","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}