Nginx Proxy for Mixpanel

An example nginx config that serves as a proxy to Mixpanel's Ingestion API and JavaScript library endpoints. To learn more, visit our Self-Hosted Tracking Docs.

Development and release

Developement

1. Make changes to nginx.conf, Dockerfile or any other file.
2. Build docker image: make
3. Locally run with: docker run --rm -p 8081:80 mixpanel-proxy (listens on port 8081)

Release

1. Ensure you are on master and have no uncommitted changes
2. Build docker image: make
3. Tag docker image: make tag
4. Publish to dockerhub: make push

Installation

There are a few ways you can use this repo to deploy a server that can be use to proxy Mixpanel API requests: one-click deploy to cloud, build a docker image, or copy and paste the nginx settings to your own nginx config file.

Option 1: One-click Deploy

• Run on Google Cloud
• Deploy to DigitalOcean

Option 2: Docker Image

Assuming you have Docker installed on your system, you can do the following:

1. Clone the repo
2. Build the Docker image: docker build -t mixpanel-proxy .
3. Run a container using the image: docker run --name my-tracking-proxy -d -p 8080:80 mixpanel-proxy
4. Visit http://localhost:8080

For production, you would deploy this docker image to whatever servers you run your production services on.

Option 3: Add locations to your existing Nginx config

If you already have servers running nginx, you can copy and paste the locations from the nginx.conf file in this repo and adjust the locations to match your preference.