Formato
Todo erro volta com o status HTTP certo e o mesmo formato:Autenticação e limites
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.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.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.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.
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.
A conta passou dos pedidos por minuto ou por dia do plano.O que fazer: Espere o
Retry-After. Veja os limites.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.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
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.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.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.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.
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
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).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.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.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).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.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.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.O plano já tem o máximo de projetos. Traz
limit.O que fazer: Exclua um projeto ou mude de plano.Site ou API num plano sem sites (Free).O que fazer: Envie como
bot ou veja os planos pagos.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.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.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.Nome reservado, ou que lembra banco, marca ou órgão público. Traz
field.O que fazer: Escolha outro.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 doPOST /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
O projeto está instalando ou já tem outra ação em curso.O que fazer: Espere alguns segundos e tente de novo.
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.
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.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.A conta está suspensa por falta de pagamento. Parar continua liberado.O que fazer: Pague em Plano e cobrança. Veja Pagamento por Pix.
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.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.
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.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.
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.
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.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.
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.O backup automático diário é dos planos pagos.O que fazer: No Free, faça o backup quando quiser. Veja os planos.
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.
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.
O armazenamento dos backups não respondeu.O que fazer: Tente de novo em instantes. Nada foi alterado.
O link de download venceu (vale 5 minutos) ou foi mexido.O que fazer: Peça outro link em Pedir o link de download.
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.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.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.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.
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.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.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.
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.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.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.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.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.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.
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.
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.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.
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.
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.
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.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).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.
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.
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.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.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.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.
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.
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.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.
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.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.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.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.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.
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.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.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).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.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.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.O Blob da conta chegou a 100.000 arquivos.O que fazer: Apague os que não usa ou junte arquivos pequenos num
.zip.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.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.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.
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.
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.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.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.
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, emerror.code (status error) ou em pendingReason.code (status pending), e dizem por que ele ainda não abre o site.
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.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.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.
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.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.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.
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.
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.
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.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ê.
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.
A conta que convidou você está num plano sem equipe agora.O que fazer: Fale com quem convidou.
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 noresult do Histórico de envios, quando o deploy parou antes da instalação.
O GitHub não respondeu, e nada mudou no projeto.O que fazer: Tente de novo em alguns minutos (no painel, Implantar agora).
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.
A branch não existe no repositório. Traz
field: "branch".O que fazer: Escolha uma branch da lista.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.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.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.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.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.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.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.O código é de convite do beta, não de presente.O que fazer: Resgate em Minha conta › Perfil › Resgatar código, no painel.
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.
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.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.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.
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.
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.
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.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.
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.
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.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 campoerror 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.
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.
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.
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.
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.
Um problema do nosso lado interrompeu a instalação.O que fazer: Envie o código de novo. Veja A instalação foi interrompida.
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.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.
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.
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.

