Code Monkey home page Code Monkey logo

posthog's Introduction

PostHog header

PostHog

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.

Quick start

1-click Heroku deploy:

See PostHog docs for in-depth walk throughs on functionality.

PostHog dashboard screenshot

Join the PostHog Users Slack if you need help, want to chat, or are thinking of a new feature idea.

Features

  • 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.
  • Libraries for JS, Python, Ruby, Node + API for anything else.
  • Beautiful graphs, funnels and dashboards.
  • Super easy deploy using Docker or Heroku.

Event autocapture

Philosophy

Many engineers find it painful to work out how their products are being used. This makes design decisions tough. PostHog solves that.

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.

PostHog gives you full control over all your users' data, while letting anyone easily perform powerful analytics.

It means you can know who is using your app, how they're using, and where you lose users in the sign up process.

What's cool about this?

PostHog is the only product-focused 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.

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.

One-line docker preview

docker run -t -i --rm --publish 8000:8000 -v postgres:/var/lib/postgresql posthog/posthog:preview

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

Deploy

Production installation

The preview image has Postgres running locally and runs in debug mode.

For a production installation you have a few options:

Deploy to Heroku

Heroku is the quickest way to get a production PostHog environment up-and-running.

We recommend getting at the very least a hobby-dev Postgres and Dyno for low volumes of events.

Docker

Using the posthog/posthog:latest Docker image. You'll need to spin up a separate Postgres docker container. We've included a docker-compose.yml file that does that.

On Ubuntu

  1. Install Docker
  2. Install Docker Compose
  3. Run the following:
sudo apt-get install git
git clone https://github.com/posthog/posthog.git
cd posthog
docker-compose build
docker-compose up -d

From source

  1. Make sure you have Python >= 3.7 and pip installed
  2. Install Yarn
  3. Run the following:
git clone https://github.com/posthog/posthog.git
yarn build
pip install -r requirements.txt
gunicorn posthog.wsgi --config gunicorn.config.py --log-file -

Running behind a proxy?

Make sure you set the IS_BEHIND_PROXY environment variable which will set the HTTP_X_FORWARDED_PROTO header.

Development

Running backend (Django)

  1. Make sure you have python 3 installed python3 --version
  2. Make sure you have postgres installed brew install postgres
  3. Start postgres, run brew services start postgresql
  4. Create Database createdb posthog
  5. Navigate into the correct folder cd posthog
  6. Run python3 -m venv env (creates virtual environment in current direction called 'env')
  7. Run source env/bin/activate (activates virtual environment)
  8. Run pip install -r requirements.txt. If you have problems with this step (TLS/SSL error), then run ~ brew update && brew upgrade followed by python3 -m pip install --upgrade pip, then retry the requirements.txt install.
  9. Run migrations python manage.py migrate
  10. Run DEBUG=1 python manage.py runserver
  11. Run the tests and frontend

Running backend tests

bin/tests

Running frontend (React)

If at any point, you get "command not found: nvm", you need to install nvm, then use that to install node.

  1. Make sure you are running Django above in a separate terminal
  2. Now run bin/start-frontend
  3. Optional: If you're making changes to the editor, you'll need to do cd frontend && yarn start-editor to watch changes.

Open source / Paid

This repo is entirely MIT licensed. We charge for things like teams, permissioning, data lake integrations, and support. Please email [email protected] and we will gladly help with your implementation.

Contributors ๐Ÿฆธ

posthog's People

Contributors

timgl avatar jamesefhawkins avatar dependabot-preview[bot] avatar tannergoods avatar ellie avatar mrkurt avatar rberrelleza avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.