Introduction

vuzon is a lightweight, self-hosted panel to manage aliases, rules and destination addresses for Cloudflare Email Routing — on your own hardware.

What is vuzon?

vuzon is a lightweight web UI to manage aliases and rules for Cloudflare Email Routing and destination addresses. It is meant for personal use with your Cloudflare account on a homelab or private network — not as a public multi-tenant or “production SaaS” deployment.

Give every service its own address (netflix@yourdomain.com, shop@yourdomain.com), see at a glance which ones are active, and pause or delete the one that starts getting spam — without digging through the Cloudflare dashboard.

How it works

vuzon talks to the Cloudflare API with your token: it creates and edits routing rules, manages destination addresses and keeps the catch-all healthy. The mail itself is routed by Cloudflare — it never passes through your server.

• Aliases — create, pause, rename and delete rules; point each one at a verified inbox or discard its mail. A random-alias generator uses crypto.getRandomValues, never Math.random.
• Catch-all — pause it or change what it does. The API always writes the “match everything” matcher and offers no delete, so the fallback rule cannot quietly stop catching mail.
• Destinations — add and remove destination addresses, with verified / pending status always visible. Only verified destinations can be picked for an alias — the server enforces it, not just the UI.
• No database — the only thing on disk is one small file with your panel credentials (hashed) and the session signing key.
• No telemetry — vuzon has no backend of its own and no third-party services. Open source, auditable top to bottom.

What you need

• Docker and Docker Compose.
• A Cloudflare zone (domain) with Email Routing enabled for that zone — see Email Routing.
• A Cloudflare API token with exactly three scopes — see API token.

Head over to Install with Docker to get started, or follow the Quickstart for the full walkthrough.