Quickstart

De cero a tu buzón en 4 pasos

Necesitas Docker instalado y un dominio activo en Cloudflare. El resto lo hace vuzon.

1234
1

Requisitos

Antes de empezar, asegúrate de tener esto a mano. Todo el flujo se hace desde la terminal de tu homelab.

Docker Engine 24+ con Docker Compose v2
Un dominio gestionado en Cloudflare (nameservers activos)
Email Routing habilitado en la zona
Un token de API de Cloudflare con los tres permisos
Una dirección de destino verificada — también puedes añadirla luego desde el panel
2

Descarga y configura

terminal
$ mkdir vuzon && cd vuzon
$ curl -fsSL -O https://raw.githubusercontent.com/KN990x/vuzon/main/docker-compose.yml \
    -O https://raw.githubusercontent.com/KN990x/vuzon/main/.env.example
$ cp .env.example .env

Copia .env.example a.env y rellena tus valores:

.env
# El dominio de correo que gestionas en Cloudflare
DOMAIN=tudominio.com

# Token de API de Cloudflare — tres permisos, ver docs
CF_API_TOKEN=cf_xxxxxxxxxxxxxxxx
3

Arranca el panel

Un solo comando descarga la imagen y arranca el panel. Al arrancar, vuzon habla con la API de Cloudflare, verifica tu token y resuelve la zona y la cuenta a partir de DOMAIN.

Nota: CF_API_TOKEN necesita exactamente tres permisos — Email Routing Addresses: Edit, Email Routing Rules: Edit y Zone: Read. Ver Token de API.
terminal
$ docker compose pull && docker compose up -d
✓ Resolviendo la zona desde DOMAIN...
✓ Token de Cloudflare verificado
✓ vuzon escuchando en http://localhost:8001
4

Verifica que funciona

Abre http://localhost:8001 y termina el asistente de instalación — la primera visita te pide elegir usuario y contraseña. Después crea tu primer alias y envíale un correo de prueba; míralo llegar en el log:

terminal
$ docker compose logs -f vuzon

¡Tu buzón está listo!

A partir de aquí todo se gestiona desde el panel: alias, destinos y catch-all.

Ver documentación