PostHog - Product analytics

by posthog



PostHog is developer-friendly, self-hosted product analytics. Automate the collection of every event on your website or app, and stay in control of your users’ data.

PostHog docs explain the functionality in more depth.

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

Deploy to Heroku


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.


Using the posthog/posthog:latest Docker image.

On Ubuntu

  1. Install Docker
  2. Install Docker Compose
sudo apt-get install git
git clone
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
git clone
yarn build
pip install -r requirements.txt
gunicorn posthog.wsgi --config --log-file -


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 migrate
  10. Run DEBUG=1 python runserver

Running backend 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.

Create a new branch

If you are working on some changes, please create a new branch, submit it to github ask for approval and when it gets approved it should automatically ship to Heroku

  • Before writing anything run git pull origin master
  • Then create your branch git checkout -b %your_branch_name% call your branch something that represents what you're planning to do
  • When you're finished add your changes git add .
  • And commit with a message git commit -m "%your feature description%"
  • When pushing to github make sure you push your branch name and not master! Use git push origin %your_branch_name%