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. Search filters the list as it grows, one click copies the address before you create it, and the random-alias generator uses crypto.getRandomValues, never Math.random. See Using the panel.
• 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 — and a destination an alias still points at cannot be removed by accident.
• Rules vuzon did not create — an Email Worker route shows its script and a fan-out rule shows all its addresses. Both stay read-only: editing one would replace its action, so the panel asks first.
• English and Spanish — switch from the translate icon in the header; your choice is remembered in the browser. Error messages are localised too: the API answers with a machine-readable code and the panel writes the sentence in your language.
• No database — all that lives on disk is three small files in the data volume: your panel credentials (hashed), the cookie signing key and the session revocation mark.
• 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.