A resposta curta
No Pro, um domínio personalizado com HTTPS são três passos. Você adiciona o hostname em Domains, cria o registro DNS exato que o Cloud mostra e espera a verificação e o certificate readiness. O hostname padrão da Unbroker fica, então os health checks ainda podem usá-lo.
Um domínio custom não é mais um deploy. DNS, verificação do hostname e o certificado TLS são estados separados. Primeiro teste o app no hostname da Unbroker. Fazer deploy de novo do mesmo commit não conserta o DNS.
O fluxo do produto está em Domains and TLS. O passo a passo é Connect a custom domain and HTTPS. Como esse app ficou live está em Deploy com git push.
Confira o app antes de mexer no DNS
Abra a URL que a Unbroker fornece e chame uma rota que você espera. Se essa request falha, leia o deployment e os logs de runtime. A falha está no app. Editar o DNS não explica isso. A leitura por etapa está em Depurar um deploy com falha.
Mantenha o hostname padrão depois de adicionar o seu. A página de domínios diz que ele continua útil para health checks e para diagnosticar a configuração do domínio. O guia pede para verificar essa URL antes de mudar o roteamento de produção.
Domínios personalizados pedem Unbroker Pro, um serviço HTTP em execução e permissão para mudar o DNS do domínio. A tabela de planos lista domínios personalizados e TLS gerenciado como indisponíveis no Free e disponíveis no Pro. O Pro custa $25 por mês, com $25 de crédito de uso. O crédito reinicia a cada ciclo e não acumula. Se o uso elegível fica abaixo do crédito, a cobrança mensal continua sendo o preço do plano. Os valores atuais estão em preços.
Adicione o hostname no Cloud
Abra a visão Domains do serviço e adicione o hostname que você quer publicar, por exemplo api.example.com ou www.example.com. É assim que se adiciona um domínio custom ao app que já está no ar. O registro dessa tela é o que aponta o domínio para o serviço.
O Cloud mostra o tipo, o nome e o destino do registro DNS. Copie esses valores no seu provedor de DNS. Use os valores dessa tela. Não invente um destino a partir da URL de outro serviço ou de outro projeto.
Um domínio apex e um subdomínio podem precisar de registros diferentes. Siga o tipo de registro que o Cloud mostra e o tipo que o seu provedor aceita para esse hostname. O guia diz isso para um apex: siga o tipo de registro que o provedor aceita e as instruções de destino mostradas no Cloud.
Adicionar o hostname configura o serviço. Não edita o registrador e não cria o registro DNS por você. Você cria esse registro no provedor da zona autoritativa.
Adicione o hostname com a CLI
Os comandos documentados são:
ubctl apps domains add <serviceId> api.example.com
ubctl apps domains ls <serviceId>
ubctl apps domains status <serviceId>
Substitua o id do serviço e o hostname de exemplo. add anexa o hostname ao serviço. ls lista os domínios desse serviço. status é como você lê o estado do domínio no terminal. O mesmo limite vale: esses comandos não gravam registros no registrador. A fonte é o guia de domínio custom.
Três estados: DNS, verificação e o certificado
Espere o Cloud informar a verificação do domínio e o certificate readiness. Não são o mesmo momento.
Você cria o registro DNS. A atualização pode aparecer em resolvedores diferentes em momentos diferentes. Confira se há um registro conflitante no mesmo hostname e se você editou a zona autoritativa. Um registro na zona errada não verifica.
Depois da verificação, o certificate readiness é acompanhado na mesma visão Domains. Esse sinal é o certificado TLS gerenciado do hostname. Também se chama certificado SSL do domínio próprio. Quando estiver pronto, chame a URL HTTPS e teste uma rota da aplicação.
Se a URL padrão funciona e o domínio personalizado não responde depois do deploy, fique em DNS, verificação do hostname e certificado. Fazer deploy de novo de código sem mudanças não repara um erro de DNS. O guia pede para evitar deploys repetidos nesse caso.
Atualize as URLs do app
O hostname que as pessoas digitam é um ajuste da aplicação, além de um registro DNS. Inclua a origin nova nas allowlists de callback de OAuth, na configuração de CORS e nos trusted hosts. Se um frontend gravou a origin da API no bundle, gere o build de novo. Atualize as URLs canônicas, a origin do sitemap e os links absolutos para usarem o domínio público que você quer. Um site Astro define essa origin em site antes do build. Saída estática ou adaptador de servidor está em hospedagem Astro. O que atualizar na API e no frontend quando essas origens mudam está em deploy de um frontend e uma API separados.
Um serviço Node começa em Deploy de Node.js. Um app Next.js começa em Deploy de Next.js. Se o app foi feito no Lovable, no Bolt ou no Cursor, as verificações que uma página pública não cobre estão em App feito com IA em produção. O hostname público é um passo separado dessa lista.
Migrar o tráfego
Se esse hostname já aponta para outro lugar, baixe o TTL antes do corte e leve em conta o tempo de cache do registro atual. O guia pede para preparar o destino e levar em conta esse tempo de cache antes de trocar o tráfego de produção. Mantenha o hostname padrão da Unbroker durante a mudança.
Uma mudança de DNS não migra um banco de dados e não revoga as credenciais do host anterior. Se o tráfego antigo ainda pode chegar a esse host, os dois lados não devem escrever em armazenamentos de dados divergentes.
Sair do Railway são duas páginas. A comparação é Unbroker como alternativa ao Railway. A mudança é Migrar do Railway. Sair do Heroku é Migrar do Heroku. Este post não repete esses roteiros.
Quando o domínio custom falha e a URL padrão funciona
O app está no ar. O hostname não. Siga a lista nesta ordem:
- O registro está na zona DNS autoritativa desse domínio.
- Não há um registro conflitante no mesmo hostname.
- O tipo, o nome e o destino batem com o que o Cloud mostra. Eles não foram copiados de outro serviço.
- A visão Domains informa a verificação.
- A mesma visão informa o certificate readiness.
- Uma rota da aplicação na URL HTTPS devolve o que você espera.
Se a URL padrão também falha, volte aos logs do deployment. Isso é uma request com falha contra o app, não um estado do domínio personalizado.
Checklist
- Chame a URL padrão da Unbroker. Se falhar, depure o deployment antes de mexer no DNS.
- No Pro, adicione o hostname na visão Domains do serviço.
- Crie o registro DNS que o Cloud mostra. O tipo, o nome e o destino precisam coincidir.
- Deixe o hostname padrão no lugar.
- Espere a verificação e depois o certificate readiness.
- Atualize callbacks, CORS, trusted hosts, origins de API embutidas, URLs canônicas e o sitemap.
- Chame a URL HTTPS. Se só o domínio personalizado falha, confira a zona, os registros conflitantes, a verificação e o certificado. Não faça deploy de novo do mesmo commit para consertar o DNS.
Perguntas frequentes
Como adiciono um domínio personalizado com HTTPS ao meu app num PaaS?
No Pro, adicione o hostname na visão Domains do serviço, crie o registro DNS que o Cloud mostra e espere a verificação e o certificate readiness. O hostname padrão da Unbroker fica para os health checks. O fluxo está em Domains and TLS.
Por que o domínio personalizado falha se a URL da plataforma funciona?
O app responde no hostname da Unbroker, então o deployment já está live. Confira a zona DNS autoritativa, registros conflitantes nesse hostname, a verificação e o certificate readiness. Fazer deploy de novo do mesmo commit não conserta o DNS.
Preciso do Pro para um domínio personalizado?
Sim. A tabela de planos lista domínios personalizados e TLS gerenciado como indisponíveis no Free e disponíveis no Pro. O guia também parte de um serviço HTTP em execução e de permissão para mudar o DNS. O Pro custa $25 por mês, com $25 de crédito de uso. Veja preços e Plans.
Devo apagar o hostname padrão da Unbroker?
Não. Mantenha. Ele continua útil para health checks e para separar uma falha do app de um problema de domínio. A página de domínios manda não removê-lo.
Adicionar um domínio altera o DNS no registrador automaticamente?
Não. Adicionar o hostname configura o serviço. Você cria o registro DNS no provedor da zona autoritativa. A Unbroker não edita o registrador.
Domínio apex ou subdomínio?
Use o tipo, o nome e o destino do registro que o Cloud mostra para esse hostname. Num apex, siga também o tipo de registro que o seu provedor de DNS aceita. Não copie o destino da URL de outro serviço.
Uma mudança de DNS migra o banco de dados?
Não. Uma mudança de DNS aponta o hostname para o serviço. Ela não move linhas, arquivos nem credenciais. Se o host anterior ainda pode receber tráfego, impeça que os dois lados escrevam em armazenamentos de dados divergentes.