Subdomínio padrão
Todo projeto do tiposite ganha um endereço https://nome.cubehost.dev, com HTTPS automático e sem configurar nada. Bots não têm endereço: eles se conectam ao Discord por conta própria.
Como escolher
Defina osubdomain no cube.json, no campo do painel ao enviar, ou deixe em branco para a Cube gerar um a partir do nome do projeto (por exemplo, loja-do-ze-k3x9qa).
Alguns nomes são reservados (como
www, api, app, admin, docs) e nomes que lembram bancos, marcas e órgãos públicos são bloqueados para evitar golpes. A lista cresce quando a equipe da Cube vê um golpe novo; um site que já usa um nome continua com ele. Nos dois casos, o erro é reserved_subdomain: escolha outro.
Como trocar
Em Configurações › Rede, escreva o novo subdomínio e salve. A troca vale na hora: o endereço novo passa a funcionar e o antigo deixa de responder (mostra Este endereço não existe).Domínio próprio
Use domínios seus, comoloja.com.br, nos seus sites. O HTTPS sai sozinho, sem você cuidar de certificado. São três passos, que a página Domínios mostra no topo: informe o domínio, crie os registros no seu provedor e espere o Ativo.
Todo plano pago tem um pacote de domínios próprios na conta, dividido entre os sites como você quiser: vários no mesmo site (como cloud.meusite.com.br e docs.meusite.com.br), um em cada ou todos num site só. O www do mesmo nome no mesmo site vai junto e não conta como outro: loja.com.br e www.loja.com.br no site são 1. Os domínios que ainda estão em Verificando também contam.
Com todos em uso, um domínio novo é recusado (
plan_limit_reached) com o plano que tem mais: remova um ou mude de plano. As páginas Domínios e Configurações › Rede mostram quantos estão em uso. Só sites e APIs recebem domínio: bots não recebem visitas pela internet.
Como adicionar
1
Adicione o domínio
Em Configurações › Rede do site (ou na página Domínios), clique em Adicionar domínio e digite só o nome, como
loja.com.br. Marque Incluir também www.loja.com.br para o www ir junto, e escolha o endereço principal: Sem www ou Com www. O outro redireciona para ele. Se não marcou, dá para incluir o www depois no menu … do domínio: Incluir www.loja.com.br.2
Crie os dois registros no DNS
No lugar onde você gerencia o domínio (onde comprou ou no seu provedor de DNS), crie os registros que o painel mostra:
O
www e a raiz usam o mesmo TXT; o www precisa do próprio CNAME (www.loja.com.br → domains.cubehost.dev). Para a raiz (loja.com.br, sem nada antes), veja antes Domínio na raiz.3
Espere o Ativo
A Cube confere sozinha a cada minuto, e o status muda de Verificando para Ativo. A mudança no DNS pode levar alguns minutos. O HTTPS sai sozinho. Verificar confere na hora.
Domínio na raiz
Na raiz (loja.com.br, sem nada antes), o certificado HTTPS só sai quando o DNS mostra o CNAME para domains.cubehost.dev de verdade. A raiz quase nunca aceita CNAME, e o ALIAS, o ANAME e o CNAME achatado (CNAME flattening) da maioria dos provedores, como Hostinger, Namecheap e Porkbun, respondem só com os endereços, sem o CNAME. Com eles, a raiz não ativa: o painel mostra o domínio em Erro, com a explicação, e a API devolve error.code: "root_alias_unsupported". Não existe TXT a mais que resolva.
O caminho que funciona em qualquer provedor:
- Use o
wwwcomo endereço principal. Adicionewww.loja.com.br, com oCNAMEparadomains.cubehost.dev. Como owwwé um subdomínio, oCNAMEfunciona em todo provedor. - Redirecione a raiz para o
wwwno seu provedor, se ele tiver redirecionamento (ou encaminhamento) de domínio: mandeloja.com.brparahttps://www.loja.com.br. Na Cube, não adicione a raiz. Se ela já estiver lá, remova.
CNAME da raiz funciona. O domínio continua registrado onde está; só os servidores DNS mudam.
Como funciona
- Só o domínio verificado abre o site. Sem o TXT, o domínio não abre nada, mesmo com o CNAME apontado.
- Um domínio é de uma conta só. Cadastrar um domínio que outra conta já verificou dá
domain_taken. Quem cadastrou antes sem o TXT não toma o domínio de ninguém: vale quem provar a posse. Se o domínio é seu e está em outra conta, fale com o suporte. - Vários domínios no mesmo site: cada um tem o próprio TXT, o próprio HTTPS e o próprio status, e remover um não mexe nos outros. Cada um abre o site direto ou redireciona para outro domínio do mesmo site (
308, mantendo o caminho), como owwwlevando à raiz. Dá para inverter o principal depois, no menu do domínio: Tornar o endereço principal. - Enquanto o endereço principal não está Ativo, o domínio que redireciona para ele abre o site direto, para ninguém cair num endereço que ainda não abre. Quando o principal fica Ativo, o redirecionamento liga sozinho, em até um minuto.
- Sem o TXT em 7 dias, a Cube para de conferir sozinha e o status vira Erro; Verificar volta a procurar.
- Site parado ou sem responder: quem abrir o domínio vê a página da Cube dizendo isso, nunca um erro cru. Veja Site não abre.
- Erro no certificado HTTPS: confira se o
CNAMEaponta paradomains.cubehost.deve clique em Verificar, que pede o certificado de novo. Na raiz, veja Domínio na raiz. - Remover faz o domínio parar de abrir o site na hora. Para usar de novo, é só adicionar outra vez: o TXT continua o mesmo.
- Sem nenhum site, não dá para adicionar domínio: o domínio próprio aponta para um site. A página Domínios diz isso e tem Publicar um site, que abre o Novo projeto com a Publicação na web já ligada; o site ganha o endereço em
cubehost.devcom HTTPS, e o domínio entra depois. - Página Domínios: cada site é um grupo com o nome, o ID, quantos domínios tem e o status. Clique no grupo para ver os domínios dele. A busca no topo acha pelo domínio, pelo nome do projeto ou pelo ID, e abre os grupos com resultado. No grupo de um site, Adicionar outro domínio (ou Adicionar domínio, no site ainda sem nenhum) já vem com o site escolhido. O topo da página diz quantos domínios do plano estão em uso.
- Trocar de plano pago não mexe nos domínios: quem muda para um plano com menos domínios do que já usa fica com todos no ar e só não adiciona outro até ficar abaixo do pacote novo. No fim do beta (a conta volta ao Free, sem site), eles param de abrir os sites, sem ser apagados.

