La respuesta corta
En Pro, un dominio personalizado con HTTPS son tres pasos. Agregás el hostname en Domains, creás el registro DNS exacto que muestra Cloud, y esperás la verificación y el certificate readiness. El hostname default de Unbroker se queda, así los health checks pueden seguir usándolo.
Un dominio custom no es un deploy más. DNS, la verificación del hostname y el certificado TLS son estados distintos. Primero probá la app en el hostname de Unbroker. Redesplegar el mismo commit no arregla el DNS.
El flujo de producto está en Domains and TLS. La guía es Connect a custom domain and HTTPS. Cómo ese deploy llegó a live está en Desplegar con git push.
Revisá la app antes de tocar el DNS
Abrí la URL que da Unbroker y pedí una ruta que esperás. Si esa request falla, leé el deployment y los logs de runtime. La falla está en la app. Editar el DNS no la explica. Cómo leer la etapa está en Depurar un deploy fallido.
Dejá el hostname default después de agregar el tuyo. La página de dominios dice que sigue sirviendo para health checks y para diagnosticar la configuración del dominio. La guía pide verificar esa URL antes de cambiar el ruteo de producción.
Los dominios personalizados piden Unbroker Pro, un servicio HTTP en ejecución y permiso para cambiar el DNS del dominio. La tabla de planes los lista, junto con el TLS gestionado, como no disponibles en Free y disponibles en Pro. Pro sale $25 por mes, con $25 de crédito de uso. El crédito se reinicia en cada ciclo y no se acumula. Si el uso elegible queda por debajo del crédito, el cargo mensual sigue siendo el precio del plan. Las cifras actuales están en precios.
Agregá el hostname en Cloud
Abrí la vista Domains del servicio y agregá el hostname que querés publicar, por ejemplo api.example.com o www.example.com. Así se agrega un dominio custom a una app que ya está corriendo. El registro de esa pantalla es el que apunta el dominio al servicio.
Cloud muestra el tipo, el nombre y el destino del registro DNS. Copiá esos valores en tu proveedor de DNS. Usá los valores de esa pantalla. No inventes un destino a partir de la URL de otro servicio o de otro proyecto.
Un dominio apex y un subdominio pueden necesitar registros distintos. Seguí el tipo de registro que muestra Cloud y el tipo que soporta tu proveedor para ese hostname. La guía lo dice para un apex: seguí el tipo de registro que soporta tu proveedor y las instrucciones de destino que muestra Cloud.
Agregar el hostname configura el servicio. No edita el registrador y no crea el registro DNS por vos. Ese registro lo creás en el proveedor de la zona autoritativa.
Agregá el hostname con la CLI
Los comandos documentados son:
ubctl apps domains add <serviceId> api.example.com
ubctl apps domains ls <serviceId>
ubctl apps domains status <serviceId>
Reemplazá el id del servicio y el hostname de ejemplo. add adjunta el hostname al servicio. ls lista los dominios de ese servicio. status es cómo leés el estado del dominio desde la terminal. El mismo límite aplica: estos comandos no escriben registros en el registrador. La fuente es la guía de dominio custom.
Tres estados: DNS, verificación y el certificado
Esperá a que Cloud informe la verificación del dominio y el certificate readiness. No son el mismo momento.
El registro DNS lo creás vos. La actualización puede verse en distintos resolvers en momentos distintos. Revisá si hay un registro en conflicto en el mismo hostname y si editaste la zona autoritativa. Un registro en la zona equivocada no verifica.
Después de la verificación, el certificate readiness se sigue desde la misma vista Domains. Esa señal es el certificado TLS gestionado del hostname. También se lo llama certificado SSL del dominio propio. Cuando está listo, pedí la URL HTTPS y probá una ruta de la aplicación.
Si la URL default anda y el dominio personalizado no responde después del deploy, quedate en DNS, verificación del hostname y certificado. Redesplegar código sin cambios no repara un error de DNS. La guía pide evitar redeploys repetidos en ese caso.
Actualizá las URLs de la app
El hostname que escribe la gente es un ajuste de la aplicación, además de un registro DNS. Sumá el origin nuevo a las allowlists de callbacks de OAuth, a la configuración de CORS y a los trusted hosts. Si un frontend dejó el origin de la API horneado en el bundle, reconstruilo. Actualizá las URLs canónicas, el origin del sitemap y los links absolutos para que usen el dominio público que querés. Un sitio Astro fija ese origen en site antes del build. Salida estática o adaptador de servidor está en hosting para Astro. Qué actualizar en la API y en el frontend cuando esos orígenes cambian está en desplegar un frontend y una API por separado.
Un servicio Node arranca en Desplegar Node.js. Una app Next.js arranca en Desplegar Next.js. Si la app se hizo en Lovable, Bolt o Cursor, los chequeos que una página pública no cubre están en App hecha con IA a producción. El hostname público es un paso aparte de esa lista.
Mudar el tráfico
Si este hostname ya apunta a otro lado, bajá el TTL antes del corte y tené en cuenta el tiempo de caché del registro actual. La guía pide preparar el destino y tener en cuenta ese tiempo de caché antes de cambiar el tráfico de producción. Dejá el hostname default de Unbroker durante la mudanza.
Un cambio de DNS no migra una base de datos y no revoca las credenciales del host anterior. Si el tráfico viejo todavía puede llegar a ese host, evitá que los dos lados escriban en almacenes de datos distintos.
Salir de Railway son dos páginas. La comparación es Unbroker como alternativa a Railway. La mudanza es Migrar de Railway. Salir de Heroku es Migrar de Heroku. Este post no repite esas guías.
Cuando falla el dominio custom y la URL default anda
La app está arriba. El hostname no. Seguí la lista en orden:
- El registro está en la zona DNS autoritativa de ese dominio.
- No hay un registro en conflicto en el mismo hostname.
- El tipo, el nombre y el destino coinciden con lo que muestra Cloud. No se copiaron de otro servicio.
- La vista Domains informa la verificación.
- La misma vista informa el certificate readiness.
- Una ruta de la aplicación en la URL HTTPS devuelve lo que esperás.
Si la URL default también falla, volvé a los logs del deployment. Eso es un request fallido contra la app, no un estado del dominio personalizado.
Checklist
- Pedí la URL default de Unbroker. Si falla, depurá el deployment antes de tocar el DNS.
- En Pro, agregá el hostname en la vista Domains del servicio.
- Creá el registro DNS que muestra Cloud. Que coincidan tipo, nombre y destino.
- Dejá el hostname default en su lugar.
- Esperá la verificación y después el certificate readiness.
- Actualizá callbacks, CORS, trusted hosts, origins de API embebidos, URLs canónicas y el sitemap.
- Pedí la URL HTTPS. Si solo falla el dominio personalizado, revisá la zona, los registros en conflicto, la verificación y el certificado. No redesplegues el mismo commit para arreglar el DNS.
Preguntas frecuentes
¿Cómo agrego un dominio personalizado con HTTPS a mi app en un PaaS?
En Pro, agregá el hostname en la vista Domains del servicio, creá el registro DNS que muestra Cloud y esperá la verificación y el certificate readiness. El hostname default de Unbroker queda para los health checks. El flujo está en Domains and TLS.
¿Por qué falla el dominio personalizado si la URL de la plataforma anda?
La app responde en el hostname de Unbroker, así que el deployment ya está live. Revisá la zona DNS autoritativa, los registros en conflicto en ese hostname, la verificación y el certificate readiness. Redesplegar el mismo commit no arregla el DNS.
¿Hace falta Pro para un dominio personalizado?
Sí. La tabla de planes lista los dominios personalizados y el TLS gestionado como no disponibles en Free y disponibles en Pro. La guía también pide un servicio HTTP en ejecución y permiso para cambiar el DNS. Pro sale $25 por mes, con $25 de crédito de uso. Mirá precios y Plans.
¿Tengo que borrar el hostname default de Unbroker?
No. Dejalo. Sigue sirviendo para health checks y para separar una falla de la app de un problema de dominio. La página de dominios dice que no lo saques.
¿Agregar un dominio cambia el DNS en el registrador automáticamente?
No. Agregar el hostname configura el servicio. El registro DNS lo creás vos en el proveedor de la zona autoritativa. Unbroker no edita el registrador.
¿Dominio apex o subdominio?
Usá el tipo, el nombre y el destino del registro que muestra Cloud para ese hostname. En un apex, seguí también el tipo de registro que soporta tu proveedor de DNS. No copies el destino de la URL de otro servicio.
¿Un cambio de DNS migra la base de datos?
No. Un cambio de DNS apunta el hostname al servicio. No mueve filas, archivos ni credenciales. Si el host anterior todavía puede recibir tráfico, evitá que los dos lados escriban en almacenes de datos distintos.