PostHog

Release Notes

Patch changes

• a29315a19c Sourcemap, dSYM, and ProGuard uploads now end with a single per-run summary line reporting how many chunks were uploaded, skipped as already present on the server, and skipped as too large. The summary is logged even when a run fails partway, and the same counts are attached to the error_tracking_cli_sourcemaps_upload_finished telemetry event so skip rates are queryable. — Thanks @ablaszkiewicz!

Install posthog-cli 0.9.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/PostHog/posthog/releases/download/posthog-cli/v0.9.4/posthog-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/PostHog/posthog/releases/download/posthog-cli/v0.9.4/posthog-cli-installer.ps1 | iex"

Install prebuilt binaries into your npm project

npm install @posthog/cli@0.9.4

Download posthog-cli 0.9.4

| File | Platform | Checksum |

|--------|----------|----------|

| posthog-cli-aarch64-apple-darwin.tar.gz | Apple Silicon macOS | checksum |

| posthog-cli-x86_64-apple-darwin.tar.gz | Intel macOS | checksum |

| posthog-cli-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |

| posthog-cli-aarch64-unknown-linux-gnu.tar.gz | ARM64 Linux | checksum |

| posthog-cli-x86_64-unknown-linux-gnu.tar.gz | x64 Linux | checksum |

| posthog-cli-aarch64-unknown-linux-musl.tar.gz | ARM64 MUSL Linux | checksum |

| posthog-cli-x86_64-unknown-linux-musl.tar.gz | x64 MUSL Linux | checksum |

<p align="center">

<img alt="posthoglogo" src="https://user-images.githubusercontent.com/65415371/205059737-c8a4f836-4889-4654-902e-f302b187b6a0.png">

</p>

<p align="center">

<a href='https://posthog.com/contributors'><img alt="GitHub contributors" src="https://img.shields.io/github/contributors/posthog/posthog"/></a>

<a href='http://makeapullrequest.com'><img alt='PRs Welcome' src='https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=shields'/></a>

<img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/posthog/posthog"/>

<a href="https://github.com/PostHog/posthog/commits/master"><img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/posthog/posthog"/> </a>

<a href="https://github.com/PostHog/posthog/issues?q=is%3Aissue%20state%3Aclosed"><img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/posthog/posthog"/> </a>

</p>

<p align="center">

<a href="https://posthog.com/docs">Docs</a> - <a href="https://posthog.com/community">Community</a> - <a href="https://posthog.com/roadmap">Roadmap</a> - <a href="https://posthog.com/why">Why PostHog?</a> - <a href="https://posthog.com/changelog">Changelog</a> - <a href="https://github.com/PostHog/posthog/issues/new?assignees=&labels=bug&template=bug_report.yml">Bug reports</a>

</p>

<p align="center">

<a href="https://www.youtube.com/watch?v=1FZji2L-LmM">

<img src="https://res.cloudinary.com/dmukukwp6/image/upload/demo_thumb_68d0d8d56d" alt="PostHog Demonstration">

</a>

</p>

PostHog is the open source platform for building self-driving products

PostHog provides every tool you need to build a successful product, and captures all the context agents need to proactively diagnose problems, uncover opportunities, and ship fixes:

• Self-driving mode: Turn signals in your product data (errors, rage clicks, failed queries, and more) into researched reports and pull requests you review and merge.
• Product analytics: Autocapture or manually instrument event-based analytics to understand user behavior and analyze data with visualization or SQL.
• Web analytics: Monitor web traffic and user sessions with a GA-like dashboard. Easily monitor conversion, web vitals, and revenue.
• Session replays: Watch real user sessions of interactions with your website or mobile app to diagnose issues and understand user behavior.
• Feature flags: Safely roll out features to select users or cohorts with feature flags.
• Experiments: Test changes and measure their statistical impact on goal metrics. Set up experiments with no-code too.
• 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.
• Surveys: Ask anything with our collection of no-code survey templates, or build custom surveys with our survey builder.
• Data warehouse: Sync data from external tools like Stripe, Hubspot, your data warehouse, and more. Query it alongside your product data.
• 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.
• AI observability: Capture traces, generations, latency, and cost for your LLM-powered app.
• Workflows: Create workflows that automate actions or send messages to your users.

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

Best of all, all of this is free to use with a generous monthly free tier for each tool. Get started by signing up for PostHog Cloud US or PostHog Cloud EU.

Table of Contents

• PostHog is the open source platform for building self-driving products
• Table of Contents
• Getting started with PostHog
• PostHog Cloud (Recommended)
• Self-hosting the open-source hobby deploy (Advanced)
• Setting up PostHog
• Learning more about PostHog
• Contributing
• Open-source vs. paid
• We’re hiring!

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, 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, you can set it up by installing our JavaScript web snippet, one of our SDKs, or by using 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 warehouse, 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:

• Vote on features or get early access to beta functionality in our roadmap
• Open a PR (see our instructions on developing PostHog locally)
• Submit a feature request or bug report

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!

<img src="https://res.cloudinary.com/dmukukwp6/image/upload/v1/posthog.com/src/components/Home/images/mission-control-hog" alt="Hedgehog working on a Mission Control Center" width="350px"/>

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.