Every sale gets a receipt.

See which ad actually made you money, what that customer really cost, and prove it.
Self-hosted ad attribution, revenue ledger and CRM.
Free to self-host. Source available (FSL-1.1). Your server, your data.

Website · Install · Docs · Features · Developers · Roadmap

What is AdLedger?

AdLedger joins ad spend (Meta, Google and 7 more networks), website events from a 2.4 KB pixel, leads and real payments (Stripe and 12 more) into one ledger, so every number is computed in SQL, split to the cent and shown per campaign, ad set and ad. One container plus PostgreSQL, on a server you control.

Not sure yet? Take the 3D product tour, or run the demo below with 90 days of sample data.

What you get

Free to self-host, with the source on GitHub. No per-seat or revenue-share pricing. Unlimited users, workspaces and client logins.
Your data never leaves your server. No telemetry, no licence check, no phone-home.

Install in 60 seconds

You need Docker. This starts AdLedger with 90 days of demo data:

git clone https://github.com/ShubhamVankalas/adledger.git && cd adledger
ADMIN_EMAIL=admin@example.com ADMIN_PASSWORD=adledger-demo-123 DEMO_DATA=true docker compose up -d

Open http://localhost:3000 and sign in. The demo runs on mock connectors that speak each platform's real API format (Meta, Google, TikTok, LinkedIn, Microsoft, Stripe). Or run plain docker compose up -d, create your account and choose Explore with demo data.

$env:ADMIN_EMAIL="admin@example.com"; $env:ADMIN_PASSWORD="adledger-demo-123"; $env:DEMO_DATA="true"
docker compose up -d

curl -fsSL https://raw.githubusercontent.com/ShubhamVankalas/adledger/main/install.sh | DOMAIN=ads.yourcompany.com sh

Render, Railway, Coolify and friends

Where	How
Render	uses render.yaml: web service, managed PostgreSQL 16 and a generated APP_SECRET.
Railway	Deploy from your fork (uses the Dockerfile and railway.json), add PostgreSQL, set DATABASE_URL=${{Postgres.DATABASE_URL}}.
Coolify, Dokploy, CapRover, Portainer	Deploy docker-compose.yml as-is.
Single container, no PostgreSQL	docker run -d -p 3000:3000 -v adledger:/data ghcr.io/shubhamvankalas/adledger (embedded database; fine for trials, use PostgreSQL for production).

pnpm install && pnpm dev     # http://localhost:3000, embedded database in ./.data

Upgrade with docker compose pull && docker compose up -d. Backups, HTTPS and every setting: docs/SELF_HOSTING.md.

Features

A dashboard you arrange yourself

The Overview is a widget board. Press Customize (or E) to drag, resize and group widgets and pin up to six KPI tiles. Start from a preset (Minimal, E-commerce, Lead gen, Agency) or set the workspace default for the whole team. A briefing line names what mattered, built from SQL numbers, not a language model. KPI tiles with change vs the previous period, sparklines and a metric explorer. Date presets, compare, platform filter and attribution model live in the URL, so every view is a link.

Live

Visitors on your site right now, today vs the same time yesterday, and a real-time feed of ad clicks, visits, leads, payments and refunds (server-sent events, no extra service). The Live pill in every page header shows visitors and today's revenue, one click from Live. Streamer mode (S) hides names. Sale alerts (A) pop a toast for every payment.

Performance and attribution

	Campaigns, ad sets and ads with column presets, NC-ROAS, a platform gap column (what the platform reports next to what AdLedger verified), a quadrant that sorts campaigns into scale, test, fix and kill, and saved views with a peek into the people a campaign brought in.
First touch, last touch and linear, switchable anywhere, with exact integer-cent splits that always add up to the payment. Paths shows the journeys customers took, Time to convert shows whether your attribution window is long enough, and unattributed revenue is always shown, never hidden.
	Customers: LTV and cohorts. Lifetime value by acquiring channel, LTV:CAC and a cohort heatmap by first-payment month (retention, cumulative LTV or revenue), with a dot where each cohort paid back its CAC. Renewals are credited to the journey that first acquired the customer.

Signature money features

Ad Receipts. Every payment shows which ads earned it, what that customer cost in ad spend and when they paid it back. Customer costs plus unallocated equal total spend, to the cent.	Profit Ledger. Enter cost of goods, payment fees and shipping once. Get contribution, profit after ads, POAS, break-even ROAS and a P&L waterfall, plus which ads bring buyers who refund.
Truth Gap. "Meta says its ads made you this much; real payments from people who clicked them were that much." Claimed vs verified conversions and value per platform and campaign.	Too-early guardrails. Median and p80 days from first click to first payment, a "too early to judge" tag on young campaigns, and pause drafts you download as a Meta or Google Ads Editor file. AdLedger never writes to your ad accounts.

A CRM that knows what each lead cost

Contacts. Saved views, filters, groups, bulk actions with undo, fast at 10k+ contacts.

Record page. Ad clicks, visits, forms and payments on one timeline, plus notes, tasks and attribution.

Pipeline. Drag by mouse, touch or keyboard. Payments move contacts to Won automatically.

Also: My tasks, CSV import with a preview before anything is written, and duplicate review and merge with re-attribution.

Reports, PDFs and AI documents

Eleven print-ready PDF reports: executive summary, weekly performance, attribution model comparison, LTV and cohorts, wasted spend, channel mix, lead source quality, creative and ad leaderboard, funnel and time to convert, pipeline and CRM activity and profit and refunds. Your logo on the masthead, a methodology appendix, a "Prepared for" watermark and a fingerprint on every page that anyone can check at /verify. Download, call the API, or schedule weekly or monthly emails. Rendered in-process: no headless browser, no extra container. docs/REPORTS.md

AI document generator. Pick one of 12 prompt templates (monthly client report, board update, post-mortem, budget memo, Meta vs Google, lead quality audit, stand-up, case study, creative brief, quarter review, funnel leaks, refunds) or write your own. Your model writes the words; AdLedger draws every KPI, table and chart from SQL, removes any sentence with a number that is not in the data, and lays it out as a branded, fingerprinted PDF with an in-app preview.

Insights and Ask AI

Action cards (move budget, room to grow, revenue drop, CAC up) where every figure links to its source row, a weekly report marked All numbers verified, and Ask: plain-language questions answered from read-only SQL tools, with the table each answer came from. Any number a model invents is flagged. Works with no model at all, a local model (Ollama, LM Studio) or OpenAI, Anthropic, Gemini, OpenRouter, DeepSeek and any OpenAI-compatible endpoint.

Alerts, sharing, goals and speed

• Alert rules on CAC, CPL, ROAS, spend, revenue or leads with cooldowns, plus optional anomaly detection.
• Notifications by email, Slack, Discord, Microsoft Teams, SMS (Twilio) or signed webhook.
• Share links: read-only aggregate dashboards with locked filters, an expiry, a view count and one-click revoke. Contact details are never shared.
• Targets and goals with pacing and projection to period end.
• Ctrl K / ⌘K finds any page, contact or campaign; G then a letter jumps between pages; ? lists shortcuts.
• Product tour: a 2-minute spotlight tour on first sign-in that shows each person only what their role can open.
• Your colours: 20 solid themes and 10 gradients for the whole organization, all passing WCAG AA. Profit and loss stay green and red.
• Custom roles with per-page and per-action permissions, next to five built-in roles (owner, admin, analyst, viewer, client).
• Installable on your phone (PWA) with a bottom tab bar, and a dark mode that follows your system.

Developers: API, webhooks, recipes

A dedicated Developers area (owners and admins by default) for wiring AdLedger into your own tools:

• API keys with scopes (reports:read, mcp, contacts:read, contacts:pii, ingest:write), optional expiry, stored hashed.
• Signed outbound webhooks for lead.created, contact.created, contact.updated, payment.succeeded and payment.refunded: HMAC-SHA256 signatures, retries with backoff for about two days, a 30-day delivery log with redeliver, Send test event, masked emails unless you opt in, private URLs blocked. docs/WEBHOOKS.md
• API reference generated from the OpenAPI 3.1 spec, with curl, JavaScript and Python examples. docs/API.md
• Recipes you can copy: SMS a new lead in seconds (Twilio), send a Cal.com booking link, shout out payments in Slack, connect Zapier, Make or n8n, or append rows to Google Sheets.

# Pull leads with a read key
curl -H "Authorization: Bearer al_..." https://your-adledger/api/v1/leads

MCP server for AI assistants

Ask Claude, Cursor or any MCP client "which ads made money last month?" against your own ledger. Create a key in Developers → API keys, then:

claude mcp add --transport http adledger https://your-adledger/api/mcp --header "Authorization: Bearer al_..."

Integrations

Connected from Settings → Integrations, with step-by-step instructions on each card and a mock mode for every connector.

Connectors other than Meta, Google Ads and Stripe are in beta: tested against real-format fixtures, not yet verified on live accounts. Details: docs/CONNECTORS.md.

Screenshots

Overview	Revenue and ROAS by attribution model
Time to convert	Time to money and pause drafts
Ask your numbers	Security policy and posture checklist
30+ integrations	Guided setup checklist

More: tracking, team, alerts, audit log, two-factor sign-in, notifications, report verification

Tracking snippet and consent modes	Members and roles
Alert rules and anomaly detection	Hash-chained audit log
Two-factor sign-in and devices	Notification channels
Verify a PDF report

On your phone: installable as an app, with a floating tab bar and a one-tap filter sheet.

Security and compliance

AdLedger is self-hosted software, so it holds no certification and makes no compliance claim on your behalf. It ships GDPR-ready tooling and SOC 2-aligned controls to help you meet GDPR, UK GDPR, CCPA/CPRA and India's DPDP; when you self-host, you are the data controller. SOC 2 and ISO 27001 assess the organisation that runs a service, so they apply to you, not to the project. What AdLedger gives that organisation is controls and evidence that make those audits easier.

Not covered: HIPAA and health data, and children's data. Card data never touches AdLedger (your payment provider holds it). See what is not covered and the go-live checklist.

Read the Trust and security page for the mechanisms and the hardening checklist, and the Compliance guide for the framework mappings and the statements that are safe to make about your install.

Architecture

One Next.js app and PostgreSQL. The dashboard, REST API, pixel collector, webhooks, MCP server, live stream, PDF rendering and background jobs all run in a single container.

 your website ──al.js──▶ /api/v1/collect ─────┐
 forms, CRMs ──webhook─▶ /api/v1/webhooks ────┤
 Stripe, stores ─webhook▶ /api/v1/webhooks ───┼──▶  AdLedger (Next.js)  ──▶  PostgreSQL 16
 ad platforms ◀── scheduled sync / uploads ───┤        ▲ dashboard, /share, /verify
 Claude, Cursor ──MCP──▶ /api/mcp ────────────┘        └──▶ signed webhooks out

Stack: Next.js 16 · React 19 · TypeScript · PostgreSQL 16 (Drizzle ORM, embedded PGlite for trials) · Tailwind CSS v4 + shadcn/ui · Recharts · react-pdf · Vercel AI SDK · MCP SDK · vitest · Playwright. Details and design decisions: docs/ARCHITECTURE.md.

Documentation

Roadmap

What is shipped and what is next lives in docs/ROADMAP.md. Ideas and votes are welcome in issues.

Contributing

pnpm install
pnpm dev                   # http://localhost:3000, embedded database, no Docker needed
pnpm test                  # vitest on an embedded Postgres, every connector mocked
pnpm lint && pnpm typecheck
pnpm build && pnpm e2e     # Playwright browser tests with axe accessibility checks

Bug reports, connectors, report kinds and docs fixes are welcome. Start with CONTRIBUTING.md and the roadmap. Found a security issue? See SECURITY.md.

License

AdLedger is source available under the Functional Source License, FSL-1.1-ALv2, a "Fair Source" licence. It is not an OSI-approved open source licence.

• What you can do: use it and self-host it for free, including for a business or an agency running its own ads, read and modify the code, and contribute changes back.
• What you can't do: sell it, sell a modified version, or offer it (or something substantially similar built from it) as a competing product or hosted service.
• After two years: each version automatically converts to the permissive Apache-2.0 licence, counted from the date that version was released.

Contributions are accepted under the same licence (see CONTRIBUTING.md). The name and logo are covered by TRADEMARKS.md. The WordPress plugin in integrations/wordpress is a separate work licensed GPL-2.0-or-later, as WordPress.org requires.

---

Built by Shubham Vankalas, as a free-to-self-host tool for founders who want to know which ad paid off.

If AdLedger shows you which ad made you money, give it a star. It helps other founders find it.

Website · Issues · Contribute