{"id":13393558,"url":"https://github.com/umami-software/umami","last_synced_at":"2025-05-12T16:20:08.887Z","repository":{"id":37025970,"uuid":"280363952","full_name":"umami-software/umami","owner":"umami-software","description":"Umami is a modern, privacy-focused alternative to Google Analytics.","archived":false,"fork":false,"pushed_at":"2025-05-12T07:16:12.000Z","size":19743,"stargazers_count":26365,"open_issues_count":76,"forks_count":4872,"subscribers_count":117,"default_branch":"master","last_synced_at":"2025-05-12T16:19:43.034Z","etag":null,"topics":["analytics","charts","google-analytics","statistics","web-analytics"],"latest_commit_sha":null,"homepage":"https://umami.is","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/umami-software.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-07-17T07:59:00.000Z","updated_at":"2025-05-12T15:33:44.000Z","dependencies_parsed_at":"2023-12-26T20:31:00.770Z","dependency_job_id":"b68457b1-7aa8-4e9e-968e-2ab938f1e70a","html_url":"https://github.com/umami-software/umami","commit_stats":null,"previous_names":["mikecao/umami"],"tags_count":99,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umami-software%2Fumami","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umami-software%2Fumami/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umami-software%2Fumami/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umami-software%2Fumami/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/umami-software","download_url":"https://codeload.github.com/umami-software/umami/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253774593,"owners_count":21962199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","charts","google-analytics","statistics","web-analytics"],"created_at":"2024-07-30T17:00:55.952Z","updated_at":"2025-05-12T16:20:08.872Z","avatar_url":"https://github.com/umami-software.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://content.umami.is/website/images/umami-logo.png\" alt=\"Umami Logo\" width=\"100\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eUmami\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ci\u003eUmami is a simple, fast, privacy-focused alternative to Google Analytics.\u003c/i\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/umami-software/umami/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/release/umami-software/umami.svg\" alt=\"GitHub Release\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/umami-software/umami/blob/master/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/umami-software/umami.svg\" alt=\"MIT License\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/umami-software/umami/actions\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/umami-software/umami/ci.yml\" alt=\"Build Status\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://analytics.umami.is/share/LGazGOecbDtaIwDr/umami.is\" style=\"text-decoration: none;\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Try%20Demo%20Now-Click%20Here-brightgreen\" alt=\"Umami Demo\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 🚀 Getting Started\n\nA detailed getting started guide can be found at [umami.is/docs](https://umami.is/docs/).\n\n---\n\n## 🛠 Installing from Source\n\n### Requirements\n\n- A server with Node.js version 18.18 or newer\n- A database. Umami supports [MariaDB](https://www.mariadb.org/) (minimum v10.5), [MySQL](https://www.mysql.com/) (minimum v8.0) and [PostgreSQL](https://www.postgresql.org/) (minimum v12.14) databases.\n\n### Get the Source Code and Install Packages\n\n```bash\ngit clone https://github.com/umami-software/umami.git\ncd umami\nnpm install\n```\n\n### Configure Umami\n\nCreate an `.env` file with the following:\n\n```bash\nDATABASE_URL=connection-url\n```\n\nThe connection URL format:\n\n```bash\npostgresql://username:mypassword@localhost:5432/mydb\nmysql://username:mypassword@localhost:3306/mydb\n```\n\n### Build the Application\n\n```bash\nnpm run build\n```\n\n_The build step will create tables in your database if you are installing for the first time. It will also create a login user with username **admin** and password **umami**._\n\n### Start the Application\n\n```bash\nnpm run start\n```\n\n_By default, this will launch the application on `http://localhost:3000`. You will need to either [proxy](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/) requests from your web server or change the [port](https://nextjs.org/docs/api-reference/cli#production) to serve the application directly._\n\n---\n\n## 🐳 Installing with Docker\n\nTo build the Umami container and start up a Postgres database, run:\n\n```bash\ndocker compose up -d\n```\n\nAlternatively, to pull just the Umami Docker image with PostgreSQL support:\n\n```bash\ndocker pull docker.umami.is/umami-software/umami:postgresql-latest\n```\n\nOr with MySQL support:\n\n```bash\ndocker pull docker.umami.is/umami-software/umami:mysql-latest\n```\n\n---\n\n## 🔄 Getting Updates\n\nTo get the latest features, simply do a pull, install any new dependencies, and rebuild:\n\n```bash\ngit pull\nnpm install\nnpm run build\n```\n\nTo update the Docker image, simply pull the new images and rebuild:\n\n```bash\ndocker compose pull\ndocker compose up --force-recreate -d\n```\n\n---\n\n## 🛟 Support\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/umami-software/umami\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/GitHub--blue?style=social\u0026logo=github\" alt=\"GitHub\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://twitter.com/umami_software\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Twitter--blue?style=social\u0026logo=twitter\" alt=\"Twitter\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://linkedin.com/company/umami-software\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/LinkedIn--blue?style=social\u0026logo=linkedin\" alt=\"LinkedIn\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://umami.is/discord\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Discord--blue?style=social\u0026logo=discord\" alt=\"Discord\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n[release-shield]: https://img.shields.io/github/release/umami-software/umami.svg\n[releases-url]: https://github.com/umami-software/umami/releases\n[license-shield]: https://img.shields.io/github/license/umami-software/umami.svg\n[license-url]: https://github.com/umami-software/umami/blob/master/LICENSE\n[build-shield]: https://img.shields.io/github/actions/workflow/status/umami-software/umami/ci.yml\n[build-url]: https://github.com/umami-software/umami/actions\n[github-shield]: https://img.shields.io/badge/GitHub--blue?style=social\u0026logo=github\n[github-url]: https://github.com/umami-software/umami\n[twitter-shield]: https://img.shields.io/badge/Twitter--blue?style=social\u0026logo=twitter\n[twitter-url]: https://twitter.com/umami_software\n[linkedin-shield]: https://img.shields.io/badge/LinkedIn--blue?style=social\u0026logo=linkedin\n[linkedin-url]: https://linkedin.com/company/umami-software\n[discord-shield]: https://img.shields.io/badge/Discord--blue?style=social\u0026logo=discord\n[discord-url]: https://discord.com/invite/4dz4zcXYrQ\n","funding_links":[],"categories":["JavaScript","TypeScript","Apps","Web Analytics","Other","网络服务","工具列表","statistics","Developer Tools","Web"],"sub_categories":["Analytics","Packages","Webapps","网络服务_其他","Web 开发框架或模板","Web analytics (Google Analytics alternatives)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumami-software%2Fumami","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fumami-software%2Fumami","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumami-software%2Fumami/lists"}