🌐 documentación

Dominios custom con SSL automático

Dale a cada cliente de tu SaaS su propio dominio con HTTPS sin tocar certificados:

  1. Registrás el hostname y su destino interno:
curl -X POST https://tudominio.com/api/v1/domains \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domainName": "app.cliente.com", "targetUrl": "http://mi-backend:3000" }'
  1. Tu cliente apunta su DNS (CNAME al anchor, o A al servidor).
  2. En la primera visita, Caddy consulta a la API si el dominio está autorizado y emite el certificado SSL en segundos (TLS on-demand).

El proxy inyecta headers de tenant (X-Tenant-*) hacia tu backend, así una sola instancia atiende a todos tus clientes white-label.

EndpointDescripción
POST /api/v1/domainsRegistrar hostname
GET /api/v1/domainsListar y ver estado de verificación
POST /api/v1/domains/:id/verifyForzar verificación DNS

Comprar dominios (registrar integrado)

También podés comprar dominios sin salir de CloudWapp (integración Namecheap):

cloudwapp domains check midominio.com     # disponibilidad y precio
cloudwapp domains register midominio.com  # compra + DNS apuntado a tu server

Los subdominios de tus apps (mi-app.apps.tudominio.com) se enrutan solos en cada deploy — no hay que configurar nada.