Using a Proxy

Ad blockers and privacy extensions block analytics by maintaining blocklists of known domains. Requests to ingest.mostlygoodmetrics.com might never make it through.

The fix? Host a proxy on your own domain. Requests to analytics.yourdomain.com look like first-party traffic, so they don't get blocked.

Without proxy:
User → ingest.mostlygoodmetrics.com ← 🚫 Blocked

With proxy:
User → analytics.yourdomain.com → MGM ✅

Quick Deploy

The MGM Proxy is a tiny reverse proxy (~5MB, ~10MB RAM, under 1ms latency) that forwards requests to MGM.

Deploy to your preferred platform:

Platform	Deploy
Fly.io	Deploy Guide
Railway	Deploy Guide
Render	Deploy Guide
Heroku	Deploy Guide
Docker	Deploy Guide

Fly.io

Fly.io deploys close to your users with edge regions.

# Install flyctl
curl -L https://fly.io/install.sh | sh

# Clone and deploy
git clone https://github.com/Mostly-Good-Metrics/mgm-proxy.git
cd mgm-proxy
fly launch --no-deploy
fly deploy

Add a custom domain:

fly certs add analytics.yourdomain.com
# Add a CNAME record pointing to your-app.fly.dev

Railway

npm install -g @railway/cli
railway login
railway init
railway up

Add your custom domain in the Railway dashboard.

Render

1. Fork mgm-proxy
2. Create a new Web Service in Render
3. Connect your forked repo
4. Add your custom domain in service settings

Heroku

heroku create my-mgm-proxy
heroku stack:set container
git push heroku main

# Add custom domain
heroku domains:add analytics.yourdomain.com

Docker

docker run -p 8080:8080 ghcr.io/mostlygoodmetrics/mgm-proxy:latest

Or build it yourself:

git clone https://github.com/Mostly-Good-Metrics/mgm-proxy.git
cd mgm-proxy
docker build -t mgm-proxy .
docker run -p 8080:8080 mgm-proxy

Configuration

Variable	Default	Description
MGM_TARGET_URL	https://ingest.mostlygoodmetrics.com	MGM ingestion endpoint
PORT	8080	Port to listen on

Configure Your SDK

Once your proxy is deployed with a custom domain, configure your SDK to use it:

Swift

let config = MGMConfiguration(
    apiKey: "mgm_proj_your_api_key",
    baseURL: URL(string: "https://analytics.yourdomain.com")!
)
MostlyGoodMetrics.configure(with: config)

Android

val config = MGMConfiguration.Builder("mgm_proj_your_api_key")
    .baseUrl("https://analytics.yourdomain.com")
    .build()
MostlyGoodMetrics.configure(this, config)

JavaScript

import { MostlyGoodMetrics } from '@mostly-good-metrics/javascript';

MostlyGoodMetrics.configure({
    apiKey: 'mgm_proj_your_api_key',
    baseURL: 'https://analytics.yourdomain.com',
});

React Native

import MostlyGoodMetrics from '@mostly-good-metrics/react-native';

MostlyGoodMetrics.configure('mgm_proj_your_api_key', {
    baseURL: 'https://analytics.yourdomain.com',
});

Flutter

await MostlyGoodMetrics.configure(
    MGMConfiguration(
        apiKey: 'mgm_proj_your_api_key',
        baseUrl: 'https://analytics.yourdomain.com',
    ),
);

Capacitor

import MostlyGoodMetrics from '@mostly-good-metrics/capacitor';

MostlyGoodMetrics.configure('mgm_proj_your_api_key', {
    baseURL: 'https://analytics.yourdomain.com',
});

Health Check

The proxy exposes a /health endpoint for load balancer health checks:

curl https://analytics.yourdomain.com/health
# ok