selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

PostHog logo

Self-host PostHog

agent-skills-v0.4893.0

Product analytics, replay, flags and errors in one platform

ReleaseOpen CoreMIT
Updated3 minutes ago
LanguagePython
Setup difficultyAdvanced
Stars
40 814
CPU
4 vCPU
RAM
16GB RAM
Storage
more than 30GB storage
Ports
8000 (web service (UI and API) inside the deployment stack), 80 (HTTP through the bundled Caddy proxy in the hobby docker-compose deployment), 443 (HTTPS through the bundled Caddy proxy, with LetsEncrypt certificates)
Docker
posthog/posthog

What is PostHog?

PostHog alternatives

Should you self-host PostHog?

PostHog scores 81/100 on selfhost.directory (how scoring works) and ranks #1 of 26 in Analytics. It has 40 814 GitHub stars, +567 in the last 30 days.

It shipped 4409 stable releases in the past year. The latest, agent-skills-v0.4893.0, came out on 16 November 2026.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Apache DevLake (67/100, 3 199 stars). PostHog scores higher overall. See PostHog vs Apache DevLake side by side.

Features

  • A/B Testing
  • AI AssistantOn self-hosted deployments it needs ANTHROPIC_API_KEY (and OpenAI keys for SQL/regex assistance); without them it shows a not-configured message.
  • AI Observability
  • Data warehouse and SQL editor
  • Distributed Tracing
  • Error TrackingMore than two alerts is listed as lost when self-hosting.
  • Feature FlagsMulti-environment support is not included in the open-source deploy.
  • Heatmaps
  • Log Management
  • Product Analytics
  • REST API
  • SDKs for many languages
  • Session ReplayDownloading recordings is not part of the open-source deploy.
  • SurveysMultiple questions, custom colors/positioning, recurring and event-based surveys are listed as things lost when self-hosting.
  • Web analytics

PostHog README

PostHog logo

GitHub contributors PRs Welcome Docker Pulls GitHub commit activity GitHub closed issues

Docs - Community - Roadmap - Why PostHog? - Changelog - Bug reports

PostHog Demonstration

PostHog is your product's context layer

PostHog ingests and stores your analytics, errors, replays, and business data so you and your agents can query and act on it. It gives you every tool you need to build a successful product, and captures the context agents need to diagnose problems, uncover opportunities, and ship fixes:

Analytics

  • Product analytics: Autocapture or manually instrument event-based analytics to understand user behavior. Analyze your data with visualizations or SQL.
  • Web analytics: Monitor web traffic and user sessions with a GA-like dashboard. Track conversion, web vitals, and revenue.
  • Group analytics: Analyze multi-seat accounts and other groups of users.

Session replay

  • Session replay: Watch real user sessions from your website or mobile app to diagnose issues and understand user behavior.
  • Replay Vision: Let AI watch your recordings for you and turn them into queryable observations.
  • Heatmaps: See where users click, scroll, and move on your site.

Observability

  • Error tracking: Track errors, get alerts, and resolve issues to improve your product.
  • Logs: Ingest, search, and analyze log data alongside the rest of your product data.
  • Tracing: Follow distributed traces straight to the line of code that broke.

Ship and iterate

  • Feature flags: Safely roll out features to select users or cohorts.
  • Experiments: Test changes and measure their statistical impact on goal metrics. Set up experiments with no code, too.
  • Early access features (beta): Let users opt into betas and register interest in upcoming features.

Talk to users

  • Surveys: Ask anything with our collection of no-code survey templates, or build custom surveys with our survey builder.
  • Support: Run customer support with a chat widget and a unified inbox, next to the product data behind each ticket.
  • Workflows: Automate actions and messages to your users, triggered by your product data.

Data

  • Warehouse: Collect, store, transform, and query all the context behind your product. Includes a managed warehouse, 120+ sources, and a SQL editor with BI and data visualization.
  • Data pipelines: Run custom filters and transformations on your incoming data. Send it to 25+ tools or any webhook in real time, or batch export large amounts to your warehouse.
  • Endpoints: Build custom API endpoints powered by your PostHog data.

AI and agents

  • AI observability: Capture traces, generations, latency, and cost for your LLM-powered app. Run LLM-as-a-judge evaluations to catch regressions.
  • MCP analytics (beta): See how agents actually use your MCP server.
  • PostHog AI: Ask your product data anything. PostHog AI builds insights, writes SQL, and finds replays for you.
  • Self-driving: Turn signals in your product data (errors, rage clicks, failed queries, and more) into researched reports and pull requests, delivered to your Inbox for you to review and merge.

You can steer it all from Slack, web, desktop (PostHog Desktop), or your own editor via the MCP.

What is this, a readme for agents?

The remote MCP server is https://mcp.posthog.com/mcp. It routes to the correct data region (US or EU) when your human logs in. Install it into Claude Code, Cursor, Codex, VS Code, Zed, or PostHog Desktop with:

npx @posthog/wizard mcp add

The docs are indexed for you at posthog.com/llms.txt, the changelog is plain Markdown at posthog.com/changelog.md, and the setup guides for every MCP client are in the docs.

All of this is free to use with a monthly free tier for each product. No card is required, and 97% of users pay $0. Join the 500,000+ teams already shipping with PostHog by signing up for PostHog Cloud US or PostHog Cloud EU.

Table of Contents

Getting started with PostHog

PostHog Cloud (Recommended)

The fastest and most reliable way to get started with PostHog is signing up for free to PostHog Cloud or PostHog Cloud EU. Your first 1 million events, 5k recordings, 1M flag requests, 100k exceptions, 10GB of logs, and 1500 survey responses are free every month, after which you pay based on usage.

Self-hosting the open-source hobby deploy (Advanced)

If you want to self-host PostHog, you can deploy a hobby instance in one line on Linux with Docker (recommended 4GB memory):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/posthog/posthog/HEAD/bin/deploy-hobby)"

Open source deployments should scale to approximately 100k events per month, after which we recommend migrating to a PostHog Cloud.

We do not provide customer support or offer guarantees for open source deployments. See our self-hosting docs, troubleshooting guide, and disclaimer for more info.

Setting up PostHog

Once you've got a PostHog instance, the fastest way to set it up is the setup wizard, which installs and configures PostHog in your app for you:

npx -y @posthog/wizard@latest

You can also install our JavaScript web snippet, one of our SDKs, or use our API. You can also connect the MCP to bring PostHog into Claude Code, Cursor, or any MCP-compatible agent.

We have SDKs and libraries for popular languages and frameworks like:

Frontend Mobile Backend
JavaScript React Native Python
Next.js Android Node
React iOS PHP
Vue Flutter Ruby

Beyond this, we have docs and guides for Go, .NET/C#, Django, Angular, WordPress, Webflow, and more.

Once you've installed PostHog, see our product docs for more information on how to set up product analytics, web analytics, session replays, feature flags, experiments, error tracking, surveys, data sources, and more.

Learning more about PostHog

Our code isn't the only thing that's open source 😳. We also open source our company handbook which details our strategy, ways of working, and processes.

Curious about how to make the most of PostHog? We wrote a guide to winning with PostHog which walks you through the basics of measuring activation, tracking retention, and capturing revenue.

Contributing

We <3 contributions big and small:

For an overview of the codebase structure, see monorepo layout and products.

Open-source vs. paid

This repo is available under the MIT expat license, except for the ee directory (which has its license here) if applicable.

Need absolutely 💯% FOSS? Check out our posthog-foss repository, which is purged of all proprietary code and features.

The pricing for our paid plan is completely transparent and available on our pricing page.

We're hiring!

A group of hedgehogs writing code together

Hey! If you're reading this, you've proven yourself as a dedicated README reader.

You might also make a great addition to our team. We're growing fast and would love for you to join us.


If you're looking for easter eggs or abandoned ideas, please check the trash.

How to configure PostHog

  • DATABASE_URLpostgres://localhost:5432/posthog if PostHog is running in DEBUG or TEST mode, must be specified otherwise.Database URL pointing to your PostgreSQL instance.
  • REDIS_URLredis://localhost/ if PostHog is running in DEBUG or TEST mode, must be specified otherwise.Redis URL pointing to your Redis instance.
  • SECRET_KEY<randomly generated secret key>❗️ Always required. Used by Django for cryptography. Helps secure cookies, sessions, hashes, etc. Custom value required in production.
  • JWT_SIGNING_KEYFalls back to SECRET_KEYDedicated key for signing PostHog-issued JWTs. Enables rotating JWT signing independently of SECRET_KEY. When set, add the old key to JWT_SIGNING_KEY_FALLBACKS so in-flight tokens continue to validate.
  • JWT_SIGNING_KEY_FALLBACKSSECRET_KEY_FALLBACKS (when JWT_SIGNING_KEY equals SECRET_KEY), otherwise EmptyComma-separated list of previous JWT signing keys still trusted for verification, newest first. Set to an empty string to stop trusting old JWT keys without affecting SECRET_KEY_FALLBACKS.

PostHog releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Analytics

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…