Skip to content

← Atlas

Migrate from Google Analytics 4 to Rybbit: Step-by-Step Guide

Rybbit is the newest privacy-first analytics — modern UI, MIT-licensed. Younger than alternatives but growing fast.

When Rybbit is the right destination

Teams who want Plausible-class simplicity but with a more polished dashboard and slightly richer event model. Rybbit launched 2024, MIT-licensed, growing fast. Self-host or Cloud (currently free for early users).

Risk: it’s young. Feature parity vs Plausible / Matomo is partial. API stability is not yet guaranteed for production migrations.

Pre-migration checklist

  1. Verify production-readiness. Check Rybbit GitHub issues + recent releases. As of mid-2026, it’s stable for non-critical sites.
  2. Decide hosting. Cloud (early-user free tier) vs self-host (Docker-compose, Postgres + ClickHouse).
  3. Inventory custom events. Rybbit supports custom events with properties.
  4. Plan migration of historical data. Rybbit has no GA4 importer — start fresh.

Step-by-step

1. Install (Day 1)

html Rybbit tracking script
<br />
<script src="https://app.rybbit.io/api/script.js" data-site-id="123" defer></script><br />

2. Map events (Day 1-2)

js Rybbit event tracking
<br />
// GA4<br />
gtag(‘event’, ‘purchase’, { transaction_id: ‘T_123’, value: 99, currency: ‘EUR’ });</p>
<p>// Rybbit equivalent<br />
window.rybbit.event(‘purchase’, { transaction_id: ‘T_123’, value: 99, currency: ‘EUR’ });<br />

3. Self-host (optional, Day 2-3)

bash Self-host Rybbit
<br />
git clone https://github.com/rybbit-io/rybbit<br />
cd rybbit<br />
docker compose up -d<br />

4. Dual-tag + validate (Days 3-14)

Compare with Parallel-Run Validator. Expected deltas similar to Plausible (Rybbit uses similar bot-filtering approach).

5. Cutover (Day 15)

Common gotchas

  • API stability — Rybbit API may change between minor versions. Pin self-host to specific Docker tag, not `latest`.
  • Smaller community — Fewer Stack Overflow answers, smaller ecosystem of integrations.
  • Documentation gaps — Some advanced features (custom dashboards, multi-org) underdocumented as of 2026-Q2.

Frequently asked

Rybbit vs Plausible — when to pick which?

Rybbit if you want richer UI / dashboards out of the box. Plausible if you want stability and proven ecosystem. Plausible is older, has more integrations.

Is Rybbit production-ready?

For content sites, blogs, marketing sites — yes. For mission-critical e-commerce or compliance-bound enterprise — wait for v1.0 / SOC2.

Does Rybbit have funnels / cohorts?

Limited as of 2026-Q2. Roadmap includes both. For now, use raw event export + DuckDB / Metabase for funnel analysis.

Can I migrate from Rybbit later if it doesn't work out?

Yes — Rybbit data is exportable as CSV / Parquet. Treat it like any analytics tool: keep raw exports, swap UIs as needed.

Self-host hardware requirements?

2GB RAM minimum (1GB Postgres + 512MB ClickHouse + 256MB Rybbit + buffer). 4GB recommended for production.