Dominios Propios NUEVO
Cada servicio publico tiene una URL gratuita https://{servicio}-{slug}.swisblade.com. Si tenes un dominio propio, podes apuntarlo a ese servicio tambien — sin ceder el control de tu DNS. Sin delegar nameservers, sin entregar ninguna API key: solo un registro CNAME en tu propio proveedor de DNS.
Como activarlo
Agrega custom_domain a un servicio app publico:
{
"name": "my-project",
"services": {
"api": {
"type": "app",
"source": { "repo": "github.com/you/api.git", "ref": "main" },
"runtime": "node",
"port": 3000,
"public": true,
"custom_domain": "app.tuempresa.com"
}
}
}
Tambien lo podes configurar desde el dashboard: Proyecto → Settings → Custom Domains, sin tocar stack.json directamente.
Flujo de configuracion
- Guarda el dominio (desde
stack.jsono el dashboard). Esto dispara un deploy unico de tu proyecto para prepararlo para el dominio nuevo — unos segundos, aislado a tu propio proyecto. - Crea un CNAME en el dashboard de tu proveedor de DNS:
Encontra tu URL gratuita exacta en la card Public Endpoints del proyecto. Si tu proveedor de DNS proxea el trafico por default (ej. la nube naranja de Cloudflare), desactivalo para este registro — Swisblade necesita ver la conexion real para emitir un certificado y rutear el trafico.Tipo: CNAMENombre: app.tuempresa.com (o tu dominio raiz)Valor: api-{tu-slug}.swisblade.comProxy: DNS only (sin proxear)
- Apreta "Verify & Activate" en Settings una vez que el CNAME haya propagado. Swisblade chequea que el dominio efectivamente resuelva a sus servidores, y activa el ruteo y pide un certificado TLS dedicado — automaticamente, sin ninguna accion extra.
Si la verificacion falla, el error te dice a que resuelve el dominio en ese momento, para que puedas revisar tu registro de DNS.
Por que sin delegar nameservers
Algunas plataformas te piden apuntar los nameservers de tu dominio hacia ellas, tomando control de todo tu DNS. Swisblade no — vos seguis administrando tu propia zona (email, otros subdominios, todo) y solo agregas un registro. Es el mismo modelo que usan la mayoria de las plataformas de hosting grandes.
Certificados TLS
Tu URL gratuita *.swisblade.com y tu dominio propio usan certificados separados, ambos de Let's Encrypt, ambos renovados automaticamente. No hay nada que administrar.
Uso con Autenticacion
Si el servicio tambien tiene auth habilitado, tu dominio propio hereda la misma proteccion de login que la URL gratuita. Un paso extra: agrega la callback URL de tu dominio propio a la configuracion del client OAuth de tu proveedor, junto a la que ya tenias, por ejemplo para Google:
- Authorized redirect URI:
https://app.tuempresa.com/oauth2/callback - Authorized JavaScript origin:
https://app.tuempresa.com
La mayoria de los proveedores te dejan registrar multiples redirect URIs en el mismo client OAuth — no hace falta uno nuevo.
Quitar un dominio propio
Vacia el campo custom_domain (o usa el dashboard) y redeploya. La URL gratuita *.swisblade.com sigue funcionando igual — nunca se elimina.