Pular para o conteúdo principal
Procurando uma mensagem dos logs, como Cannot find module ou Used disallowed intents? Veja Solução de problemas.

Formato

Todo erro volta com o status HTTP certo e o mesmo formato:
Todo erro 429 traz o cabeçalho Retry-After, com os segundos que faltam. Espere esse tempo antes de tentar de novo.

Autenticação e limites

HTTP 401
A chave não existe, foi revogada ou está fora do formato.O que fazer: Confira o cabeçalho Authorization: Bearer cube_… ou crie outra chave no painel.
HTTP 403
A chave não tem a permissão que a rota pede. O campo requiredScope diz qual falta (por exemplo files:write), e a mensagem diz o nome dela na tela (“Arquivos · escrever”).O que fazer: No painel, em Chaves de API, abra o menu da chave, clique em Editar permissões, marque a que falta e salve (ou use outra chave). Veja as permissões.
HTTP 403
Numa equipe, a chave não pode ter permissão acima do papel de quem cria ou edita, nem do papel de quem a criou. O campo scopes lista as que passam.O que fazer: Desmarque as permissões da lista, ou peça a quem tem o papel para criar a chave. Veja Chaves de API numa equipe.
HTTP 403
Esta ação não aceita chave de API, com permissão nenhuma: a conta, a senha, as duas etapas, a cobrança, a equipe, as próprias chaves, Cube AI e algumas ações de projeto (excluir um backup ou uma versão, o backup automático, os avisos, gerar o certificado do acesso externo, excluir e restaurar um banco).O que fazer: Faça pelo painel. Veja o que cada permissão alcança.
HTTP 401
A rota é só do painel e o pedido veio sem sessão.O que fazer: Use uma rota da API pública ou faça pelo painel.
HTTP 429
A conta passou dos pedidos por minuto ou por dia do plano.O que fazer: Espere o Retry-After. Veja os limites.
HTTP 429
Ações pesadas seguidas: envio de .zip (1 a cada 3 s), abertura de logs (1 a cada 5 s por projeto, até 5 abertos) ou cancelamento da assinatura (3 por hora; o Manter assinatura não tem limite).O que fazer: Espere o Retry-After e tente de novo.
HTTP 429
10 chaves erradas do mesmo IP em 10 minutos. Chaves erradas desse IP ficam bloqueadas por 15 minutos.O que fazer: Corrija a chave. Uma chave certa continua passando.

Pedidos

HTTP 400
Um parâmetro ou o corpo está fora do formato (por exemplo, lines acima de 1000 ou uma variável com nome inválido).O que fazer: Leia a message: ela diz qual campo.
HTTP 415
O corpo não veio como JSON. Acontece, por exemplo, no curl -d sem o cabeçalho Content-Type, que manda o corpo como formulário.O que fazer: Mande Content-Type: application/json junto do corpo.
HTTP 413
O corpo JSON do pedido é grande demais.O que fazer: Mande só o que a rota pede. As variáveis, somadas, vão até 32 KB. Para o .zip, o limite é outro: veja invalid_zip.
HTTP 404
O projeto não existe ou não é da sua conta.O que fazer: Confira o ID. A resposta é a mesma nos dois casos, de propósito.
HTTP 500
Algo falhou do nosso lado.O que fazer: Tente de novo em instantes. Se continuar, fale com a gente.

Envio do .zip e configuração

HTTP 413 ou 422
413: o .zip passou do limite do plano (no envio, ou ao voltar para uma versão guardada num plano maior). Traz limitMb. 422: não é um .zip, está corrompido, vazio ou tem senha. No deploy pelo GitHub com a Pasta raiz, o 422 com rootDirectory quer dizer que o .zip que o GitHub gerou para o commit veio num formato que a Cube não consegue separar pela pasta (o repositório com 65.535 arquivos ou mais é aceito).O que fazer: Tire node_modules, venv e o que o projeto não usa (veja Limites do .zip), ou compacte de novo, sem senha. Com rootDirectory, tentar de novo dá o mesmo: envie só a pasta pelo GitHub Actions (cube deploy ./apps/web).
HTTP 422
Tem atalhos, caminhos para fora da pasta, arquivos especiais ou cresce demais ao descompactar. Traz reason: path, link, special_file, size, file_count ou compression_ratio. No deploy pelo GitHub com a Pasta raiz, o erro traz também rootDirectory: path é um arquivo do repositório com .. entre as pastas (como a\..\b: a \ conta como /), com um nome de mais de 255 bytes ou com o mesmo caminho de outro (como a\b e a/b), e file_count é a pasta com mais de 20.000 arquivos e pastas.O que fazer: Compacte só os arquivos do projeto. Com rootDirectory, renomeie o arquivo no repositório ou tire da pasta o que o projeto não usa, e dê um push.
HTTP 422
Sem cube.json no .zip e sem language e command no formulário (um .zip só de HTML, com o index.html na raiz e sem package.json nem requirements.txt, não cai aqui: vira site estático). No Restaurar como novo, um backup de antes de a Cube guardar a configuração junto e sem cube.json.O que fazer: Mande um cube.json ou os campos no formulário. No backup antigo, baixe o .zip e envie pelo Novo projeto, que pergunta a linguagem e o comando.
HTTP 422
O cube.json ou o formulário tem um campo errado ou desconhecido, ou port/subdomain num bot, ou command/version/build no site estático (static), ou um root fora dele ou fora do projeto. Traz field, quando dá para saber. A memória abaixo do mínimo do plano (bot: 256 MB nos pagos e 100 MB no Free; site: 512 MB) também cai aqui, com field: "memoryMb" e minMemoryMb: “A memória de um bot precisa ser de pelo menos 256 MB no plano Block.” Um bot que já tinha menos segue no ar; o mínimo vale ao criar e ao mudar a memória. O Lavalink tem mínimo próprio, 512 MB: “A memória de um projeto Lavalink precisa ser de pelo menos 512 MB.”O que fazer: Corrija o campo indicado. Na memória, mande memoryMb igual ou acima do minMemoryMb (ou tire a chave: vale o mínimo do plano).
HTTP 422
Linguagem ou versão fora da lista. Traz supported.O que fazer: Use Node.js 20, 22, 24 ou 26, Python 3.11, 3.12, 3.13 ou 3.14, ou static para um site só de HTML.
HTTP 422
Um nome de systemPackages não está na lista dos pacotes do sistema. Traz field: "systemPackages" e supported (a lista).O que fazer: Use só os nomes da lista, escritos igual, em minúsculas. Veja Pacotes do sistema.
HTTP 422
A memória pedida passa do que sobra no plano, somando projetos e bancos de dados. Traz freeMemoryMb e requestedMemoryMb.O que fazer: Diminua a memória deste ou de outro projeto, exclua um que não usa ou mude de plano. Veja Falta memória livre no plano.
HTTP 403
O plano já tem o máximo de projetos. Traz limit.O que fazer: Exclua um projeto ou mude de plano.
HTTP 403
Site ou API num plano sem sites (Free).O que fazer: Envie como bot ou veja os planos pagos.
HTTP 403
A linguagem pede mais memória que o plano inteiro tem: Java (256 MB no mínimo) no Free (100 MB). Vem com minMemoryMb.O que fazer: Veja os planos pagos ou envie o projeto em outra linguagem. Veja Hospedar Java.
HTTP 403
O template pede mais memória que o plano inteiro tem: o Lavalink (512 MB no mínimo) no Free (100 MB). Vem com minMemoryMb, e a mensagem diz de qual plano ele está disponível.O que fazer: Veja os planos pagos: o Lavalink entra a partir do Block. Veja Lavalink.
HTTP 403
O plano já tem o máximo de sites. Traz limit.O que fazer: Exclua um site ou mude de plano.
HTTP 422
Subdomínio fora do formato. Traz field.O que fazer: De 3 a 32 caracteres: letras minúsculas, números e hífen, sem hífen nas pontas.
HTTP 422
Nome reservado, ou que lembra banco, marca ou órgão público. Traz field.O que fazer: Escolha outro.
HTTP 409
Outro site já usa esse subdomínio. Traz field.O que fazer: Escolha outro.
HTTP 409
Os servidores estão cheios agora (“Indisponível no momento” em Preços e no checkout; isAvailable: false em Listar planos). Nunca acontece com o Monolith nem com o Empresas, que estão sempre à venda.O que fazer: Tente de novo mais tarde: libera sozinho quando abre espaço. Nada foi cobrado nem apagado.

Avisos do envio

Não são erros: o envio dá certo e o projeto instala. A resposta do POST /projects e do POST /projects/{id}/code traz hints, com o que a análise viu no .zip (o resultado compilado no lugar do código-fonte, ou pastas que o build gera de novo). Cada aviso tem code e message, como os erros. Mais em Envie o código-fonte, não o compilado.

Iniciar, parar e reiniciar

HTTP 409
O projeto está instalando ou já tem outra ação em curso.O que fazer: Espere alguns segundos e tente de novo.
HTTP 409
A última instalação falhou, então não há o que iniciar.O que fazer: Confira os logs da instalação, corrija e envie o código de novo. Veja A instalação não terminou.
HTTP 409
O projeto veio de um template e ainda não tem uma variável obrigatória dele, como o DISCORD_TOKEN. Traz missingVariables com os nomes. Vale ao iniciar, reiniciar e voltar uma versão com shouldStart; parar continua liberado.O que fazer: Defina o valor em Definir variáveis (no painel, na aba Projeto ou em Configurações › Variáveis de ambiente) e inicie de novo. Veja Como pegar o token do bot.
HTTP 422
Ligar este projeto passa da memória do plano com os que já estão ligados. Traz freeMemoryMb e requestedMemoryMb. Também ao adicionar um domínio com todos os domínios próprios do plano em uso (o www do mesmo nome no mesmo site não conta): traz limit (o pacote da conta), used e suggestedPlanId (o plano mais barato com mais domínios, ou null).O que fazer: Pare outro projeto ou diminua a memória deste. Veja Não cabe no seu plano agora. No domínio, remova um dos que você tem ou mude para o plano de suggestedPlanId.
HTTP 409
A conta está suspensa por falta de pagamento. Parar continua liberado.O que fazer: Pague em Plano e cobrança. Veja Pagamento por Pix.
HTTP 409
A equipe da Cube suspendeu a conta, por exemplo por algo contra a Política de Uso Aceitável. A message traz o motivo, que também foi por e-mail e aparece no painel. Como numa suspensão, enviar código, iniciar, reiniciar, fazer backup, restaurar backup e voltar versão ficam bloqueados, e nenhum Pix sai; parar e baixar backups e versões continuam liberados. Pagar não tira esta suspensão. Na equipe de outro dono, a pessoa suspensa só lê: toda ação que muda algo, pelo painel ou pelas chaves de API que ela criou ali, responde este código. O link temporário do Blob da conta suspensa sai só pelo painel: pela chave de API, também responde este código.O que fazer: Fale com o suporte no Discord da Cube. Veja Suspensão pela equipe.
HTTP 409
O beta acabou de terminar e a conta está voltando ao Free. Também aparece ao resgatar um código de presente nesses minutos.O que fazer: Espere alguns minutos. Nada foi apagado.
HTTP 409
A conta está no Free e ainda não pegou a vaga do /free no Discord da Cube, então o bot não sobe. Nada mudou.O que fazer: Vincule o Discord em Integrações, use /free no canal 🔧・commands do Discord da Cube e tente de novo, ou assine um plano. Veja Plano Free.
HTTP 409
A conta perdeu a vaga do Free porque a meta de mensagens da semana no Discord não foi batida. Os projetos ficam parados e, como numa suspensão, enviar código, iniciar, reiniciar, fazer backup, restaurar backup e voltar versão ficam bloqueados. Parar e baixar backups e versões continuam liberados.O que fazer: Assine um plano em Plano e cobrança: o que estava no ar sobe sozinho. Veja Plano Free.
HTTP 503
O servidor dos projetos não respondeu a tempo.O que fazer: Tente de novo em instantes. Nada foi alterado. A exceção é o restaurar de um backup e a volta para uma versão: sem resposta no meio, o projeto fica parado e a mensagem diz isso; confira os arquivos antes de iniciar.
HTTP 503
Não deu para abrir as variáveis do projeto agora. Aparece também ao iniciar, reiniciar ou enviar código novo, porque o projeto não sobe sem as variáveis.O que fazer: Tente de novo em instantes. Nada foi gravado.

Backups

Veja Backups.
HTTP 409
O projeto (ou o banco de dados) já tem um backup na fila ou sendo feito. É um por vez em cada um.O que fazer: Espere ele ficar pronto em Listar backups e peça outro.
HTTP 409
O backup ainda está sendo feito ou não deu certo, então não dá para baixar nem restaurar.O que fazer: Espere o status virar ready ou use outro backup.
HTTP 403
O backup automático diário é dos planos pagos.O que fazer: No Free, faça o backup quando quiser. Veja os planos.
HTTP 507
O backup (ou a versão do Aplicar mudanças), os arquivos de agora e os restaurados não cabem juntos no espaço do projeto. Nada mudou: os arquivos ficaram como estavam e, se o projeto estava no ar, ele voltou ao ar. No Restaurar como novo, os arquivos do backup não cabem no espaço de um projeto novo, e nada foi criado.O que fazer: Apague arquivos grandes que o projeto não usa e restaure de novo.
HTTP 422
O backup (ou a versão do Aplicar mudanças) não abriu na hora de restaurar. Os arquivos e o projeto ficaram como estavam (se ele estava no ar, voltou ao ar). No backup de um banco de dados, nada chegou ao banco. No Restaurar como novo, nada foi criado (o banco novo também sai).O que fazer: Restaure outro backup (ou volte para outra versão) da lista.
HTTP 503
O armazenamento dos backups não respondeu.O que fazer: Tente de novo em instantes. Nada foi alterado.
HTTP 403
O link de download venceu (vale 5 minutos) ou foi mexido.O que fazer: Peça outro link em Pedir o link de download.
Um backup que não deu certo fica com status: "failed" e o motivo em error.code: too_large (o projeto passa de 500 MB ou de 20.000 arquivos sem as dependências), empty (não há arquivo para guardar) ou backup_failed (falha do nosso lado; tente de novo).

Versões dos envios

Veja Versões e voltar atrás.
HTTP 409
A versão não está mais guardada: passou do limite do plano ou dos 30 dias, foi excluída, ou a linha não guarda arquivos (uma troca da versão da linguagem ou um backup restaurado, por exemplo). Nada mudou.O que fazer: Escolha uma versão com isRestorable no Histórico de envios ou envie o .zip de novo.
HTTP 503
O armazenamento das versões não respondeu.O que fazer: Tente de novo em instantes. Nada foi alterado.

Bancos de dados

Veja Bancos de dados.
HTTP 403
O plano não inclui bancos de dados: eles vêm a partir do Stack. Também aparece ao ligar um banco numa conta que voltou a um plano sem bancos.O que fazer: Mude de plano em Plano e cobrança. Veja os planos.
HTTP 403
O plano já tem todos os bancos que permite (Stack 1, Tower 3, Fortress 6). Ao iniciar, conta os bancos ligados. Traz limit ao criar.O que fazer: Exclua (ou pare) um banco que não usa, ou mude de plano.
HTTP 409
Esse tipo de banco ainda chega em breve e não pode ser criado (hoje, todos estão liberados). Traz field: "engine". Nada foi criado.O que fazer: Escolha outro tipo de banco.
HTTP 503
O acesso externo aos bancos ainda não está liberado, então o certificado não foi gerado. Nada mudou no banco.O que fazer: Conecte pelos projetos da sua conta, pelo endereço interno, e tente o acesso externo mais tarde.
HTTP 400
O pedido de certificado (CSR) do acesso externo não vale: não é um CSR, está cortado, passa de 8 KB ou a assinatura dele não confere com a chave (pedido editado, ou assinado com SHA-1). Traz field: "csrPem". Nada mudou no banco.O que fazer: Gere o pedido de novo com o comando do painel, sem editar o arquivo, e envie o .csr inteiro.
HTTP 400
O nome do pedido de certificado não é o id deste banco: o CN tem de ser exatamente o id dele, sem outros campos. Traz field: "csrPem". Nada mudou no banco.O que fazer: Use o comando da página do banco, que já traz o id no -subj "/CN=…", e envie o pedido novo.
HTTP 400
A chave do pedido de certificado não é aceita. Valem EC P-256, com a curva pelo nome, e RSA de 2048 a 4096 bits. Traz field: "csrPem". Nada mudou no banco.O que fazer: Gere a chave e o pedido de novo com o comando do painel (no macOS, com o -pkeyopt ec_param_enc:named_curve) e envie o pedido novo.
HTTP 400
O nome não vale. Ele é o endereço que os projetos usam, então tem de 3 a 32 caracteres, só letras minúsculas sem acento, números e hífen, começa com letra, não termina em hífen, não é localhost e não começa com cube.O que fazer: Escolha um nome como loja-db e tente de novo.
HTTP 400
A memória do banco está abaixo do mínimo do tipo (512 MB, ou 256 MB no Redis) ou acima da memória do plano. Traz minMemoryMb.O que fazer: Mande um memoryMb entre o mínimo e a memória do plano.
HTTP 409
Você já tem um banco com esse nome. O nome não repete na conta (outra conta pode usar o mesmo, e o dela é outro banco).O que fazer: Escolha outro nome.
HTTP 409
O banco já tem uma ação em andamento, como o backup do dia ou uma restauração. Nada mudou.O que fazer: Espere alguns segundos e tente de novo.
HTTP 409
Para restaurar um backup do PostgreSQL, do MySQL ou do MongoDB, ou para fazer um backup agora, o banco precisa estar no ar.O que fazer: Inicie o banco, espere ficar running e tente de novo.
HTTP 422
O banco recusou o backup no meio da restauração. No PostgreSQL a restauração é tudo ou nada e os dados ficam como estavam; no MySQL e no MongoDB, parte dos dados pode ter mudado.O que fazer: Confira os dados do banco antes de usar e restaure outro backup da lista.

Arquivos do projeto

Os erros da aba Arquivos e das rotas /projects/{id}/files da API (com a chave com files:read ou files:write). invalid_path e file_too_large estão na seção do Blob, com o caso dos arquivos.
HTTP 403
O plano Free não inclui os arquivos do projeto (nem pelo painel nem pela API).O que fazer: Mude para um plano pago em Plano e cobrança e tente de novo.
HTTP 404
O arquivo ou a pasta não existe no projeto (pode ter sido apagado ou movido).O que fazer: Liste a pasta de novo e confira o caminho.
HTTP 403
O caminho fica dentro da pasta das dependências (node_modules, ou a vendor do PHP), que a Cube cria na instalação, ou no __pycache__, que o Python cria ao rodar. As duas são só leitura; só a pasta das dependências pode ser apagada inteira.O que fazer: Para trocar uma dependência, mude o package.json (ou o arquivo das dependências da linguagem) e aplique as mudanças; para instalar tudo de novo, apague a pasta inteira e inicie o projeto.
HTTP 409
Já existe um arquivo ou pasta com esse nome no destino.O que fazer: Escolha outro nome, ou mande shouldOverwrite: true para trocar o arquivo (só de arquivo para arquivo).
HTTP 422
O caminho é um atalho (link) ou um arquivo especial, ou passa por um. A Cube não segue links.O que fazer: Apague o atalho ou troque pelo arquivo de verdade.
HTTP 422
O arquivo não é texto (UTF-8), então não abre como conteúdo.O que fazer: Baixe o arquivo pelo link de download.
HTTP 409
O envio em partes parou no meio: a conexão caiu, outro envio começou no projeto ou a parte não continua de onde a anterior parou.O que fazer: Envie o arquivo de novo, do começo (offset=0), com outro uploadId.
HTTP 411
A parte do envio veio sem o cabeçalho Content-Length.O que fazer: Mande o tamanho da parte no Content-Length e envie de novo.
HTTP 507
O disco do projeto está cheio, em tamanho ou em número de arquivos. A mensagem diz o disco do seu plano, e a resposta traz projectDiskGb, projectFileLimit e suggestedPlanId (o plano mais barato com mais disco; null no Empresas).O que fazer: Apague arquivos que o projeto não usa e tente de novo, ou mude para um plano com mais disco por projeto. Veja Disco cheio.
HTTP 413
O .zip da seleção passa de 500 MB ou de 20.000 arquivos.O que fazer: Escolha menos arquivos, ou baixe o projeto inteiro por um backup.
HTTP 422
Nada da seleção entra no .zip: atalhos, arquivos especiais e as pastas das dependências ficam de fora.O que fazer: Escolha outros arquivos e peça o .zip de novo.
HTTP 422
O projeto não tem o que reinstalar: falta o arquivo das dependências na raiz (package.json, requirements.txt, go.mod, composer.json…).O que fazer: Envie o arquivo das dependências e tente de novo.

Blob

Veja Blob.
HTTP 403
O plano Free não tem Blob. Quem desceu para o Free continua listando, baixando e apagando o que já guardou; só o envio fica recusado.O que fazer: Assine um plano pago em Plano e cobrança. Veja os planos.
HTTP 413
O arquivo não cabe na cota do Blob do plano. No pedido do envio, contam também os envios em andamento: o envio simples nos 15 minutos do link (mesmo cancelado) e o envio em partes por 24 horas (até terminar ou ser apagado); na confirmação, o que já está guardado (e o arquivo sai). Traz usedBytes, quotaBytes e sizeBytes.O que fazer: Apague arquivos que não usa, espere os envios em andamento terminarem (ou apague os que desistiu) ou mude para um plano maior.
HTTP 413
No Blob: o arquivo passa do maior aceito no plano (1/5 da cota, até 4 GB: Block 1 GB, Stack 2 GB, do Tower em diante 4 GB), pelo painel, pela API ou pela CLI. Traz maxBytes. (No explorador de arquivos do projeto, o limite é outro: 1 MB no editor e 500 MB por arquivo enviado, de qualquer tipo.)O que fazer: Divida o arquivo em partes menores ou mude para um plano maior e envie de novo. Pelo painel, as fotos já são reduzidas antes de subir.
HTTP 400
No Blob: o nome do arquivo não vale. Ele tem até 1024 bytes, pastas separadas por /, sem / no começo ou no fim, sem pasta vazia, . ou .., sem \ e sem caractere de controle. (No explorador de arquivos, o caminho precisa ficar dentro da pasta do projeto.)O que fazer: Troque o nome (ex.: img/logo.png) e peça o envio de novo.
HTTP 409
A confirmação chegou antes de o arquivo terminar de subir pelo link do envio, ou ele chegou com outro tamanho. No envio em partes, traz missingParts: as partes que faltam ou chegaram com o tamanho errado.O que fazer: Termine o PUT no link e confirme de novo. Se o link venceu (15 minutos para começar), peça outro envio. No envio em partes, mande só as de missingParts e confirme de novo.
HTTP 409
O envio em partes passou das 24 horas sem terminar (ou foi apagado): a Cube cancelou e nada ficou guardado.O que fazer: Peça o envio de novo e mande todas as partes.
HTTP 409
A rota das partes num arquivo que não está sendo enviado em partes (o envio simples, ou um arquivo já confirmado).O que fazer: Confira o id, ou peça o envio com isMultipart: true.
HTTP 409
Com shouldOverwrite: false, já existe um arquivo com o mesmo nome. Nada mudou.O que fazer: Envie com shouldOverwrite: true para trocar, ou com shouldAddRandomSuffix: true para um nome novo.
HTTP 422
A regra da pasta só aceita algumas extensões, e a do arquivo não está entre elas. Traz folder (a pasta da regra que vale) e allowedExtensions.O que fazer: Envie para outra pasta ou troque a regra (na aba Regras de pasta do Blob, ou em Salvar as regras de pasta).
HTTP 413
O arquivo passa do tamanho máximo da regra da pasta. Traz folder e maxBytes.O que fazer: Diminua o arquivo, envie para outra pasta ou troque a regra.
HTTP 409
Mais regras de pasta que o plano tem (1 por GB da cota, até 50: Block 5, Stack 10, Tower 25). Traz limit. Nada mudou.O que fazer: Junte ou remova regras e salve de novo, ou mude para um plano maior.
HTTP 400
Uma regra de pasta tem a pasta fora da regra do nome (.., \, pasta vazia), uma extensão torta (só letras e números, como png ou tar.gz), ou há duas regras para a mesma pasta. Nada mudou.O que fazer: Corrija a regra que a message diz e salve de novo.
HTTP 409
O Blob da conta chegou a 100.000 arquivos.O que fazer: Apague os que não usa ou junte arquivos pequenos num .zip.
HTTP 503
O armazenamento do Blob não respondeu. Nada mudou: o arquivo que você ia apagar continua lá, e nenhum link saiu.O que fazer: Espere alguns instantes e tente de novo.

Domínio próprio

Veja Endereço e domínios.
HTTP 503
O domínio próprio está fora do ar agora. Nada mudou: tente de novo mais tarde.O que fazer: Use o endereço do site em cubehost.dev, que já tem HTTPS, e tente de novo em alguns minutos.
HTTP 403
A conta está no Free, que não tem site, então não tem domínio próprio. Ele vem em todo plano pago, a partir de 3 domínios no Block.O que fazer: Assine um plano pago em Plano e cobrança.
HTTP 422
Domínio próprio ou análise num bot. Bots não recebem visitas pela internet.O que fazer: Use o domínio e a análise num site ou numa API.
HTTP 400
O domínio veio fora do formato: com https://, barra, porta, curinga, só uma parte (loja) ou um IP.O que fazer: Mande só o nome, como loja.com.br ou www.loja.com.br.
HTTP 422
Endereços em cubehost.dev e o do painel não podem ser domínio próprio.O que fazer: Use um domínio seu. Para mudar o endereço em cubehost.dev, troque o subdomínio em Configurações › Rede.
HTTP 409
O domínio já está em outro site da sua conta, ou outra conta já provou que é dona dele.O que fazer: Remova o domínio do outro site da conta antes. Se ele é seu e está em outra conta, fale com o suporte.
HTTP 422
O redirectTo não é outro domínio deste site, é ele mesmo ou já redireciona para um terceiro.O que fazer: Escolha um domínio do mesmo site que abre o site direto.

Estado do domínio

Estes não são erros HTTP: vêm no domínio, em error.code (status error) ou em pendingReason.code (status pending), e dizem por que ele ainda não abre o site.
Domínio › error
A Cube não achou o TXT _cube-verify em 7 dias e parou de conferir sozinha.O que fazer: Confira o nome e o valor do TXT no DNS do domínio e clique em Verificar (ou chame Verificar domínio agora), que volta a procurar.
Domínio › error
O certificado HTTPS não saiu.O que fazer: Confira se o CNAME (ou o ALIAS da raiz) aponta para domains.cubehost.dev e clique em Verificar, que pede o certificado de novo. Na raiz, veja Domínio na raiz.
Domínio › error
A conta está no Free, que não tem site, e o domínio parou de abrir o site. Nada foi apagado.O que fazer: Assine qualquer plano pago: o domínio volta sozinho.
Domínio › error
A raiz do domínio usa ALIAS, ANAME ou CNAME achatado (ou registros A com os endereços), e o DNS responde só com os endereços, sem o CNAME. Assim, o certificado HTTPS da raiz não sai.O que fazer: Use o www como endereço principal (com o CNAME para domains.cubehost.dev) e redirecione a raiz para ele no seu provedor; ou fale com o suporte para levar o DNS a um provedor em que o CNAME da raiz funciona. Veja Domínio na raiz.

Equipes

Veja Equipes. Estes códigos vêm das telas do painel e da área de trabalho de uma equipe; a chave de API segue a própria permissão.
HTTP 403
Numa equipe, o seu papel não faz esta ação: Leitura mudando algo, Desenvolvedor na cobrança, nas chaves de API, no GitHub ou nas pessoas, ou Admin na cobrança. Traz role (o seu papel) e requiredRole (o que a ação pede).O que fazer: Peça a um Admin ou ao dono da equipe para trocar o seu papel, ou para fazer a ação.
HTTP 409
O plano da conta não tem equipe. A equipe vem a partir do Tower (Free, Block e Stack não têm).O que fazer: Mude para o Tower ou um plano maior em Plano e cobrança e convide de novo.
HTTP 409
A equipe chegou ao limite do plano: 3 membros além do dono no Tower, 7 no Fortress, somando os convites pendentes. A mensagem diz o limite do seu plano. No aceite de um convite, quer dizer que a equipe desceu de plano e está sem vaga agora (o convite continua valendo até vencer).O que fazer: Cancele um convite pendente, remova alguém ou mude para um plano maior e convide de novo. Quem foi convidado fala com quem convidou.
HTTP 409
Você tentou dar a vaga a uma pessoa que já tem acesso à equipe. Acontece quando a lista mudou (outra aba, alguém removido) depois de você abrir a página.O que fazer: Recarregue a página Equipes e veja quem está sem acesso pelo plano.
HTTP 409
O e-mail convidado já é do dono ou de alguém da equipe. Traz field: "email".O que fazer: Para mudar o que a pessoa faz, troque o papel dela na lista.
HTTP 404
O link do convite não vale mais: venceu (7 dias), foi cancelado, foi reenviado (o novo link troca o antigo) ou já foi usado.O que fazer: Peça um convite novo a quem convidou você.
HTTP 403
O convite é para outro e-mail. Só a conta com o e-mail convidado entra.O que fazer: Entre com a conta desse e-mail (ou crie uma com ele) e abra o link de novo.
HTTP 409
A conta que convidou você está num plano sem equipe agora.O que fazer: Fale com quem convidou.
HTTP 409
Ninguém troca o próprio papel. O mesmo vale para cannot_remove_yourself (remover a si mesmo pela lista), owner_role_fixed, owner_cannot_be_removed e owner_cannot_leave (o dono é sempre Dono e não sai da própria equipe).O que fazer: Peça a outro Admin ou ao dono. Para deixar a equipe, use Sair da equipe.

Deploy pelo GitHub

Veja Deploy pelo GitHub. Esses códigos aparecem no painel e no result do Histórico de envios, quando o deploy parou antes da instalação.
HTTP 503
O GitHub não respondeu, e nada mudou no projeto.O que fazer: Tente de novo em alguns minutos (no painel, Implantar agora).
HTTP 404
O repositório ou a branch não estão mais liberados para a Cube, ou a conexão com o GitHub é de outra conta.O que fazer: Em Integrações, clique em Repositórios no GitHub e libere o repositório de novo, ou confira a branch em Configurações › Deploy.
HTTP 422
A branch não existe no repositório. Traz field: "branch".O que fazer: Escolha uma branch da lista.
HTTP 413
O repositório compactado passa do limite do .zip do plano. Com a Pasta raiz, é o repositório inteiro que passa de 100 MB compactado, o máximo que a Cube baixa para separar a pasta, e o erro traz também rootDirectory. Traz limitMb.O que fazer: Tire do repositório arquivos grandes que o projeto não usa (as dependências são instaladas na Cube) ou mude de plano. Se o repositório tem mais de um app, escolha a Pasta raiz do app em Configurações › Deploy. Com a Pasta raiz já escolhida (o erro traz rootDirectory), os 100 MB valem em todo plano e mudar de plano não ajuda: tire do repositório o que nenhum app usa (vídeos, backups, builds) ou envie só a pasta pelo GitHub Actions.
HTTP 400
A Pasta raiz não é um caminho de pasta válido: tem .., ., \, duas barras seguidas, um caractere de controle ou mais de 255 caracteres. Traz field: "rootDirectory".O que fazer: Escreva o caminho a partir da raiz do repositório, separado por /, como apps/web. Para usar o repositório inteiro, deixe o campo vazio.
HTTP 422
A Pasta raiz não existe na branch (ou é um arquivo, não uma pasta). No deploy, aparece no histórico quando a pasta sumiu do commit. Traz field: "rootDirectory".O que fazer: Confira o caminho em Configurações › Deploy, com as letras maiúsculas e minúsculas, e a branch.
HTTP 413
A Pasta raiz compactada passa do limite do .zip do plano. Traz limitMb e rootDirectory.O que fazer: Tire da pasta arquivos grandes que o projeto não usa (as dependências são instaladas na Cube) ou mude de plano.
HTTP 409
Implantar agora num projeto que recebe o código pelo envio do .zip.O que fazer: Escolha o GitHub em Configurações › Deploy e salve.

Avisos

Veja Avisos por e-mail.
HTTP 403
Os avisos por e-mail são dos planos pagos, então não dá para ligar no Free.O que fazer: No Free, acompanhe o projeto pela aba Logs. Veja os planos.

Códigos de presente

Veja Códigos de presente.
HTTP 400
O código está fora do formato CUBE-XXXX-XXXX-XXXX ou não existe. A resposta é a mesma nos dois casos.O que fazer: Confira se digitou igual ao que recebeu (letras e números; O vira 0 e I ou L viram 1) e tente de novo.
HTTP 400
O código é de convite do beta, não de presente.O que fazer: Resgate em Minha conta › Perfil › Resgatar código, no painel.
HTTP 410
O código já foi resgatado. Cada código de presente vale uma vez só.O que fazer: Peça um código novo a quem deu o presente.
HTTP 410
A equipe da Cube cancelou o código.O que fazer: Peça um código novo a quem deu o presente.
HTTP 410
O prazo para resgatar o código acabou. A message traz a data.O que fazer: Peça um código novo a quem deu o presente.
HTTP 409
A conta já tem um presente valendo. Cada conta tem um presente por vez, e a message diz até quando ele vale.O que fazer: Guarde o código e resgate depois dessa data.
HTTP 409
A conta está no beta por convite. O código de presente vale depois que o beta terminar.O que fazer: Resgate quando a conta sair do beta.
HTTP 409
O Pix da renovação do plano já saiu, está atrasado ou a conta está suspensa por falta de pagamento. Também aparece ao trocar de plano ou de recorrência com o ciclo vencido.O que fazer: Pague a renovação em Plano e cobrança e tente de novo: os dias do código entram no ciclo novo.
HTTP 409
O plano da conta foi liberado pela equipe da Cube e não tem vencimento, então não há onde somar os dias de um código do mesmo plano ou de um com menos memória.O que fazer: Só um código de um plano com mais memória sobe a conta. Fale com o suporte se precisar.
HTTP 409
A conta tem um Pix de troca de plano esperando pagamento. O resgate do código (ou a renovação antecipada) mudaria o ciclo que esse Pix completa, então espera. A message diz até quando o Pix vale.O que fazer: Pague o Pix em Plano e cobrança ou espere ele vencer, e resgate o código (ou antecipe a renovação) depois.
HTTP 409
A conta está com o presente de um plano maior por cima do plano pago, então a troca de plano (ou entre mensal e anual) espera o presente acabar. Aparece no painel.O que fazer: Troque de plano depois da data do presente, em Plano e cobrança.
HTTP 409
A assinatura foi cancelada: o plano segue até o fim do ciclo, sem cobrança nova, então renovar, trocar de plano ou trocar entre mensal e anual espera. Aparece no painel.O que fazer: Em Plano e cobrança, use Manter assinatura e tente de novo. Veja Cancelar a assinatura.
HTTP 409
O próximo ciclo já está pago (pela renovação antecipada ou pela de sempre), e dá para antecipar um ciclo de cada vez. A message diz até quando o plano vai e quando dá para antecipar de novo. Aparece no painel.O que fazer: Nada a pagar agora. Antecipe de novo depois que o ciclo de agora terminar. Veja Renovação.
HTTP 409
Ao antecipar a renovação com um downgrade ou a troca entre mensal e anual agendados: a renovação sai 3 dias antes do vencimento, já com a troca. A message diz a troca e a data. Aparece no painel.O que fazer: Espere a renovação de sempre ou, para antecipar no plano de agora, desfaça a troca em Plano e cobrança e tente de novo.

Estados de erro do projeto

Quando um projeto fica Com erro ou Em loop de erro, o campo error do projeto traz um destes códigos. Eles não são erros HTTP: são o motivo de o projeto não estar no ar. Cada um tem a explicação completa, com as mensagens dos logs, em Solução de problemas.
Logs › Instalação
A instalação das dependências ou o build terminou com erro.O que fazer: Corrija o pacote ou a versão e envie de novo. Veja A instalação das dependências falhou.
Logs › Instalação
A instalação e o build passaram do tempo máximo do plano: 15 minutos nos planos pagos e 5 no Free (15 no Rust, em qualquer plano).O que fazer: Diminua as dependências ou, no Free, mude para um plano pago. O envio seguinte instala as dependências do zero. Veja A instalação demorou demais.
Logs › Instalação
A instalação passou de 2 GB de memória.O que fazer: Tire dependências que só servem para desenvolvimento. Veja A instalação ficou sem memória.
Logs › Instalação
A instalação parou porque o disco do projeto encheu: as dependências e o que o build gera não couberam no disco do plano.O que fazer: Tire dependências que o projeto não usa e envie de novo, ou mude para um plano com mais disco por projeto. Veja Disco cheio.
Logs › Instalação
Um problema do nosso lado interrompeu a instalação.O que fazer: Envie o código de novo. Veja A instalação foi interrompida.
Logs › Aplicação
Não conseguimos ligar o projeto: uma falha do nosso lado ao subir, não do seu código. Um comando de início errado não dá este código: o projeto sobe, cai e fica com process_exited ou crash_loop.O que fazer: Tente iniciar de novo em instantes. Veja Não foi possível iniciar.
Configurações › Geral
Não conseguimos preparar os pacotes do sistema escolhidos: uma falha do nosso lado, não do seu código.O que fazer: Inicie de novo em alguns minutos. Veja Os pacotes do sistema não ficaram prontos.
Logs › Aplicação
O processo caiu no plano Free, que não reinicia sozinho.O que fazer: Corrija e inicie de novo. Veja O bot parou com erro.
Logs › Aplicação
O projeto caiu 5 vezes seguidas e parou de reiniciar.O que fazer: Corrija o erro e inicie de novo. Veja O bot caiu 5 vezes seguidas.
No painel, o botão Por que caiu? pede um diagnóstico para Cube AI a partir dos logs.

Páginas que o visitante do seu site vê

Para as páginas de site parado, sem resposta, sobrecarregado ou endereço inexistente, veja Site não abre.