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:

  1. O registro está na zona DNS autoritativa desse domínio.
  2. Não há um registro conflitante no mesmo hostname.
  3. O tipo, o nome e o destino batem com o que o Cloud mostra. Eles não foram copiados de outro serviço.
  4. A visão Domains informa a verificação.
  5. A mesma visão informa o certificate readiness.
  6. 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

  1. Chame a URL padrão da Unbroker. Se falhar, depure o deployment antes de mexer no DNS.
  2. No Pro, adicione o hostname na visão Domains do serviço.
  3. Crie o registro DNS que o Cloud mostra. O tipo, o nome e o destino precisam coincidir.
  4. Deixe o hostname padrão no lugar.
  5. Espere a verificação e depois o certificate readiness.
  6. Atualize callbacks, CORS, trusted hosts, origins de API embutidas, URLs canônicas e o sitemap.
  7. 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.