Welcome to cookiepal-oss

cookiepal-oss is a self-hosted, open-source cookie-consent toolkit. It runs entirely on your machine — no SaaS accounts, no external calls, no data leaving your infrastructure.

How it works

1. Crawl — a headless Chromium walks your site, records every cookie actually set, and upserts them into a local SQLite file.
2. Dashboard — a local web UI on http://localhost:3001 to review categorization, edit copy, tune banner layout and colours, and manage translations.
3. Build — produces a drop-in cookiepal.bundle.js (self-contained IIFE with config baked in) or cookiepal-config.ts for import-based usage.
4. Backend (optional) — a self-hostable Node + Postgres service that captures accept / reject / customise events with server-stamped metadata. One container per site.

Setting up cookiepal-oss

Follow the Quickstart to install the CLI, crawl your site, and ship your first consent banner.

Next steps