# Install PostHog - Docs
## AI wizard
Install PostHog in minutes with our wizard by running this command in your project directory:
`npx @posthog/wizard@latest`
[Learn more](/wizard.md)
Wait for it to finish and test the setup once the wizard is complete.
## Frameworks and languages
The wizard supports the following frameworks and languages:
- [Android (Kotlin)](/docs/libraries/android.md)
- [Angular](/docs/libraries/angular.md)
- [Astro](/docs/libraries/astro.md)
- [Django](/docs/libraries/django.md)
- [FastAPI](https://github.com/PostHog/wizard)
- [Flask](/docs/libraries/flask.md)
- [Laravel](/docs/libraries/laravel.md)
- [Next.js](/docs/libraries/next-js.md)
- [Nuxt](/docs/libraries/nuxt.md)
- [Python](/docs/libraries/python.md)
- [React Native](/docs/libraries/react-native.md)
- [React](/docs/libraries/react.md)
- [Ruby](/docs/libraries/ruby.md)
- [Ruby on Rails](/docs/libraries/ruby-on-rails.md)
- [React Router](/docs/libraries/react-router.md)
- [SvelteKit](/docs/libraries/svelte.md)
- [Swift (iOS/macOS)](/docs/libraries/ios.md)
- [TanStack Start](https://github.com/PostHog/wizard)
- [Vue](/docs/libraries/vue-js.md)
- [ElixirComing soon](/docs/libraries/elixir.md)
- [FlutterComing soon](/docs/libraries/flutter.md)
- [GoComing soon](/docs/libraries/go.md)
- [JavaComing soon](/docs/libraries/java.md)
- [RustComing soon](/docs/libraries/rust.md)
We've got more on the way.
Check out the wizard's [GitHub repo](https://github.com/PostHog/wizard) for more details.
Set up a reverse proxy (recommended)
We recommend [setting up a reverse proxy](/docs/advanced/proxy.md), so that events are less likely to be intercepted by tracking blockers.
We have our [own managed reverse proxy service](/docs/advanced/proxy/managed-reverse-proxy.md), which is free for all PostHog Cloud users, routes through our infrastructure, and makes setting up your proxy easy.
If you don't want to use our managed service then there are several other options for creating a reverse proxy, including using [Cloudflare](/docs/advanced/proxy/cloudflare.md), [AWS Cloudfront](/docs/advanced/proxy/cloudfront.md), and [Vercel](/docs/advanced/proxy/vercel.md).
Grouping products in one project (recommended)
If you have multiple customer-facing products (e.g. a marketing website + mobile app + web app), it's best to install PostHog on them all and [group them in one project](/docs/settings/projects.md).
This makes it possible to track users across their entire journey (e.g. from visiting your marketing website to signing up for your product), or how they use your product across multiple platforms.
Add IPs to Firewall/WAF allowlists (recommended)
For certain features like [heatmaps](/docs/toolbar/heatmaps.md), your Web Application Firewall (WAF) may be blocking PostHog’s requests to your site. Add these IP addresses to your WAF allowlist or rules to let PostHog access your site.
**EU**: `3.75.65.221`, `18.197.246.42`, `3.120.223.253`
**US**: `44.205.89.55`, `52.4.194.122`, `44.208.188.173`
These are public, stable IPs used by PostHog services (e.g., Celery tasks for snapshots).
## JS snippet
HTML
PostHog AI
```html
```
## Libraries15
Custom-built libraries for integrating PostHog with popular client and server-side langauges.
- [JavaScript web](/docs/libraries/js.md)
- [React Native](/docs/libraries/react-native.md)
- [React](/docs/libraries/react.md)
- [Node.js](/docs/libraries/node.md)
- [Flutter](/docs/libraries/flutter.md)
- [iOS](/docs/libraries/ios.md)
- [Python](/docs/libraries/python.md)
- [Android](/docs/libraries/android.md)
- [PHP](/docs/libraries/php.md)
- [Java](/docs/libraries/java.md)
- [Go](/docs/libraries/go.md)
- [Ruby](/docs/libraries/ruby.md)
- [Unity](/docs/libraries/unity.md)
- [Elixir](/docs/libraries/elixir.md)
- [Rust](/docs/libraries/rust.md)
## Framework guides22
Framework-specific guides that cover our recommended approach to installing PostHog in a number of popular environments.
- [Angular](/docs/libraries/angular.md)
- [Astro](/docs/libraries/astro.md)
- [Bubble](/docs/libraries/bubble.md)
- [Django](/docs/libraries/django.md)
- [Docusaurus](/docs/libraries/docusaurus.md)
- [Flask](/docs/libraries/flask.md)
- [Framer](/docs/libraries/framer.md)
- [Gatsby](/docs/libraries/gatsby.md)
- [Google Tag Manager](/docs/libraries/google-tag-manager.md)
- [Laravel](/docs/libraries/laravel.md)
- [Next.js](/docs/libraries/next-js.md)
- [Nuxt.js](/docs/libraries/nuxt-js.md)
- [Phoenix](/docs/libraries/phoenix.md)
- [Remix](/docs/libraries/remix.md)
- [Retool](/docs/libraries/retool.md)
- [RudderStack](/docs/libraries/rudderstack.md)
- [Segment](/docs/libraries/segment.md)
- [Shopify](/docs/libraries/shopify.md)
- [Slack](/docs/libraries/slack.md)
- [Svelte](/docs/libraries/svelte.md)
- [Vue.js](/docs/libraries/vue-js.md)
- [Webflow](/docs/libraries/webflow.md)
- [WooCommerce](/docs/libraries/woocommerce.md)
- [WordPress](/docs/libraries/wordpress.md)
## API
Events can be ingested directly using our API and the [`/i/v0/e`](/docs/api/capture.md) endpoint, which is the same endpoint that all of our libraries use behind the scenes.
Generally, this isn't something you'll need to use when integrating PostHog, but if you're working with a language or framework that PostHog doesn't support yet, this will allow you to still send events.
> **Note:** For this API, you should use your 'Project token' from the 'Project' page in PostHog. This is the same token used in your frontend snippet.
## Sending events
Events can be sent either one at a time, or together in a batch. There is no limit on the number of events you can send in a batch, but the entire request body must be less than `20MB` by default.
PostHog AI
### Single
```shell
POST https://[your-instance].com/i/v0/e/
Content-Type: application/json
Body:
{
"token": "",
"event": "event_name",
"properties": {
"distinct_id": "distinct_id_of_your_user",
"key1": "value1",
"key2": "value2"
},
"timestamp": "[optional timestamp in ISO 8601 format]"
}
```
### Batch
```shell
POST https://[your-instance].com/batch/
Content-Type: application/json
Body:
{
"token": "",
"batch": [
{
"event": "event_name",
"properties": {
"distinct_id": "distinct_id_of_your_user",
"key1": "value1",
"key2": "value2"
},
"timestamp": "[optional timestamp in ISO 8601 format]"
},
...
]
}
```
> **Note:** Timestamp is optional. If not set, it'll automatically be set to the current time.
### Community questions
Ask a question
### Was this page useful?
HelpfulCould be better