2020-02-20 06:25:40 +01:00
2020-02-25 02:33:21 +01:00
# PostHog (Community Edition)
2020-01-27 06:54:19 +01:00
2020-02-20 03:33:07 +01:00
PostHog is open source product analytics, built for developers. Automate the collection of every event on your website or app, with no need to send data to 3rd parties. It's a 1 click to deploy on your own infrastructure, with full API/SQL access to the underlying data.
2020-02-09 23:39:05 +01:00
2020-02-15 06:26:54 +01:00
## Quick start
2020-02-20 09:17:11 +01:00
1-click Heroku deploy:
< a href = "https://heroku.com/deploy?template=https://github.com/posthog/posthog" > < img src = "https://www.herokucdn.com/deploy/button.svg" width = "250px" / > < / a >
2020-02-15 06:26:54 +01:00
2020-05-25 16:58:06 +02:00
See [PostHog docs ](https://posthog.com/docs/ ) for in-depth walk throughs on functionality.
2020-02-14 07:00:01 +01:00
2020-05-14 22:01:20 +02:00
2020-02-14 08:06:08 +01:00
2020-03-01 02:20:20 +01:00
Join the [PostHog Users Slack ](https://join.slack.com/t/posthogusers/shared_invite/enQtOTY0MzU5NjAwMDY3LTc2MWQ0OTZlNjhkODk3ZDI3NDVjMDE1YjgxY2I4ZjI4MzJhZmVmNjJkN2NmMGJmMzc2N2U3Yjc3ZjI5NGFlZDQ ) if you need help, want to chat, or are thinking of a new feature idea.
2020-02-20 09:36:14 +01:00
2020-02-14 07:00:01 +01:00
## Features
2020-04-14 16:11:46 +02:00
- **Event-based** analytics at a user level - see which users are doing what in your application.
- **Complete control** over your data - host it yourself.
- **Automatically capture** clicks and page views to do analyze what your users are doing **retroactively** .
2020-05-26 17:20:21 +02:00
- Libraries for ** [JS ](https://posthog.com/docs/integrations/js-integration ), [Python ](https://posthog.com/docs/integrations/python-integration ), [Ruby ](https://posthog.com/docs/integrations/ruby-integration ), [Node ](https://posthog.com/docs/integrations/node-integration ), [Go ](https://posthog.com/docs/integrations/go-integration )** + [API ](https://posthog.com/docs/integrations/api ) for anything else.
- Beautiful ** [graphs ](https://posthog.com/docs/features/trends ), [funnels ](https://posthog.com/docs/features/funnels ), [user cohorts ](https://posthog.com/docs/features/cohorts ), [user paths ](https://posthog.com/docs/features/paths ) and [dashboards ](https://posthog.com/docs/features/dashboards )**.
2020-04-14 16:11:46 +02:00
- Super easy deploy using **Docker** or **Heroku** .
2020-02-14 07:00:01 +01:00
2020-02-20 10:26:13 +01:00
## Event autocapture
< img src = "https://posthog-static-files.s3.us-east-2.amazonaws.com/Website-Assets/Creating+new+action+with+toolbar.gif" width = "100%" >
2020-02-14 07:00:01 +01:00
## Philosophy
2020-02-20 05:27:56 +01:00
Many engineers find it painful to work out how their products are being used. This makes design decisions tough. PostHog solves that.
2020-02-19 23:11:10 +01:00
We also strongly believe 3rd party analytics don't work anymore in a world of Cookie laws, GDPR, CCPA and lots of other 4 letter acronyms. There should be an alternative to sending all of your users' personal information and usage data to 3rd parties.
2020-02-20 03:30:00 +01:00
PostHog gives you full control over all your users' data, while letting anyone easily perform powerful analytics.
2020-02-14 07:00:01 +01:00
2020-02-19 23:11:10 +01:00
It means you can know who is using your app, how they're using, and where you lose users in the sign up process.
2020-02-14 08:30:05 +01:00
## What's cool about this?
2020-02-19 23:11:10 +01:00
PostHog is the only < strong > product-focused< / strong > open source analytics library, with an event and user-driven architecture. That means tracking identifiable (where applicable) user behavior, and creating user profiles. We are an open source alternative to Mixpanel, Amplitude or Heap, designed to be more developer friendly.
2020-02-14 08:30:05 +01:00
2020-02-15 02:52:00 +01:00
There are a couple of session-based open source libraries that are nice alternatives to Google Analytics. That's not what we are focused on.
2020-02-10 00:31:43 +01:00
2020-02-09 23:39:05 +01:00
## One-line docker preview
```bash
2020-02-10 00:20:11 +01:00
docker run -t -i --rm --publish 8000:8000 -v postgres:/var/lib/postgresql posthog/posthog:preview
2020-02-09 23:39:05 +01:00
```
This image has everything you need to try out PostHog locally! It will set up a server on http://127.0.0.1:8000.
## Deploy to Heroku
[](https://heroku.com/deploy?template=https://github.com/posthog/posthog)
2020-04-03 23:09:57 +02:00
## Production deployment
2020-02-09 23:39:05 +01:00
2020-05-25 16:58:06 +02:00
[See docs for production deployment ](https://posthog.com/docs/deployment )
2020-02-09 23:39:05 +01:00
2020-04-22 12:23:41 +02:00
## Developing locally
2020-03-06 23:20:32 +01:00
2020-05-25 16:58:06 +02:00
[See docs for developing locally ](https://posthog.com/docs/developing-locally )
## Contributing
We < 3 contributions big or small . [See docs for a guide on how to get started ](https://posthog.com/docs/contributing )
2020-01-27 06:54:19 +01:00
2020-02-20 09:10:18 +01:00
## Open source / Paid
2020-02-18 01:00:22 +01:00
2020-03-22 06:23:04 +01:00
This repo is entirely [MIT licensed ](/LICENSE ). We charge for things like user permissioning and auditability, a/b testing and dedicated support. Please email hey@posthog.com and we will gladly help with your implementation.
2020-02-20 09:10:18 +01:00
2020-02-20 09:14:12 +01:00
## Contributors 🦸
2020-03-06 23:20:32 +01:00
2020-02-20 09:10:18 +01:00
[//]: contributor-faces
2020-02-20 09:14:12 +01:00
< a href = "https://github.com/timgl" > < img src = "https://avatars1.githubusercontent.com/u/1727427?v=4" title = "timgl" width = "80" height = "80" > < / a >
2020-03-10 22:14:00 +01:00
< a href = "https://github.com/mariusandra" > < img src = "https://avatars2.githubusercontent.com/u/53387?v=4" title = "mariusandra" width = "80" height = "80" > < / a >
2020-04-14 16:11:46 +02:00
< a href = "https://github.com/EDsCODE" > < img src = "https://avatars0.githubusercontent.com/u/13127476?v=4" title = "EDsCODE" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/jamesefhawkins" > < img src = "https://avatars3.githubusercontent.com/u/47497682?v=4" title = "jamesefhawkins" width = "80" height = "80" > < / a >
2020-04-14 16:11:46 +02:00
< a href = "https://github.com/bhavish-agarwal" > < img src = "https://avatars3.githubusercontent.com/u/14195048?v=4" title = "bhavish-agarwal" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/Tannergoods" > < img src = "https://avatars1.githubusercontent.com/u/60791437?v=4" title = "Tannergoods" width = "80" height = "80" > < / a >
2020-04-14 16:11:46 +02:00
< a href = "https://github.com/gzog" > < img src = "https://avatars0.githubusercontent.com/u/1487006?v=4" title = "gzog" width = "80" height = "80" > < / a >
< a href = "https://github.com/Tmunayyer" > < img src = "https://avatars2.githubusercontent.com/u/29887304?v=4" title = "Tmunayyer" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/SanketDG" > < img src = "https://avatars3.githubusercontent.com/u/8980971?v=4" title = "SanketDG" width = "80" height = "80" > < / a >
2020-04-14 16:11:46 +02:00
< a href = "https://github.com/03difoha" > < img src = "https://avatars3.githubusercontent.com/u/8876615?v=4" title = "03difoha" width = "80" height = "80" > < / a >
< a href = "https://github.com/iMerica" > < img src = "https://avatars3.githubusercontent.com/u/487897?v=4" title = "iMerica" width = "80" height = "80" > < / a >
< a href = "https://github.com/pedroapfilho" > < img src = "https://avatars2.githubusercontent.com/u/13142568?v=4" title = "pedroapfilho" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/eLRuLL" > < img src = "https://avatars3.githubusercontent.com/u/1459486?v=4" title = "eLRuLL" width = "80" height = "80" > < / a >
< a href = "https://github.com/anoopemacs" > < img src = "https://avatars3.githubusercontent.com/u/12211622?v=4" title = "anoopemacs" width = "80" height = "80" > < / a >
2020-03-10 22:14:00 +01:00
< a href = "https://github.com/budnik" > < img src = "https://avatars0.githubusercontent.com/u/1160699?v=4" title = "budnik" width = "80" height = "80" > < / a >
2020-04-14 16:11:46 +02:00
< a href = "https://github.com/elliebike" > < img src = "https://avatars1.githubusercontent.com/u/53315310?v=4" title = "elliebike" width = "80" height = "80" > < / a >
2020-03-10 22:14:00 +01:00
< a href = "https://github.com/tirkarthi" > < img src = "https://avatars3.githubusercontent.com/u/3972343?v=4" title = "tirkarthi" width = "80" height = "80" > < / a >
< a href = "https://github.com/mrkurt" > < img src = "https://avatars1.githubusercontent.com/u/7724?v=4" title = "mrkurt" width = "80" height = "80" > < / a >
< a href = "https://github.com/J0" > < img src = "https://avatars0.githubusercontent.com/u/8011761?v=4" title = "J0" width = "80" height = "80" > < / a >
2020-04-14 16:11:46 +02:00
< a href = "https://github.com/manuelfcreis" > < img src = "https://avatars1.githubusercontent.com/u/29898180?v=4" title = "manuelfcreis" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/maximmarakov" > < img src = "https://avatars1.githubusercontent.com/u/36736392?v=4" title = "maximmarakov" width = "80" height = "80" > < / a >
2020-03-10 22:14:00 +01:00
< a href = "https://github.com/rberrelleza" > < img src = "https://avatars0.githubusercontent.com/u/475313?v=4" title = "rberrelleza" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/sac0" > < img src = "https://avatars2.githubusercontent.com/u/20946852?v=4" title = "sac0" width = "80" height = "80" > < / a >
2020-03-10 22:14:00 +01:00
< a href = "https://github.com/sanketsaurav" > < img src = "https://avatars2.githubusercontent.com/u/881122?v=4" title = "sanketsaurav" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/solnsubuga" > < img src = "https://avatars3.githubusercontent.com/u/23418080?v=4" title = "solnsubuga" width = "80" height = "80" > < / a >
2020-04-14 16:11:46 +02:00
< a href = "https://github.com/14MR" > < img src = "https://avatars1.githubusercontent.com/u/5824170?v=4" title = "14MR" width = "80" height = "80" > < / a >
< a href = "https://github.com/anandvenkat4" > < img src = "https://avatars2.githubusercontent.com/u/3582757?v=4" title = "anandvenkat4" width = "80" height = "80" > < / a >
2020-05-11 13:52:32 +02:00
< a href = "https://github.com/Jujhar" > < img src = "https://avatars0.githubusercontent.com/u/5521110?v=4" title = "Jujhar" width = "80" height = "80" > < / a >
