node_modules, venv) não entram: elas são instaladas de novo quando precisa.
Fazer backup agora
Uma cópia na hora, em todos os planos. Leva alguns segundos e aparece na lista quando fica pronta.
Backup automático
Uma cópia por dia de cada projeto, nos planos pagos. Vem ligado e você desliga por projeto.
Baixar
O backup sai em
.zip, por um link que vale 5 minutos e só para a sua conta.Restaurar
Os arquivos voltam aos do backup. O projeto para antes e não liga sozinho depois.
Todos os backups da conta
O item Backups da barra lateral do painel (/backups) junta os backups de todos os seus projetos, um cartão por projeto, com as mesmas ações da aba do projeto: Fazer backup agora, baixar, restaurar e excluir.
- No topo: quantos backups prontos você tem, o espaço deles, em quantos projetos o backup automático está ligado e quantos o seu plano guarda por projeto.
- Em cada projeto: quantos estão guardados do limite do plano (“2 de 3 guardados”) e se o automático está ligado. Abrir no projeto leva à aba Backups dele, onde o automático liga e desliga.
- Projeto apagado: os backups de um projeto que você excluiu (ou que o sistema apagou depois de 30 dias parado, veja Suspensão da conta) continuam aqui com o selo Apagado até vencer, para baixar ou restaurar como novo.
- Banco apagado: os backups de um banco de dados que você excluiu aparecem aqui também, com o selo Apagado, até vencer (7 dias), para baixar ou restaurar como um banco novo.
Quantos ficam guardados
Cada backup fica guardado por até 30 dias. O plano define quantos ficam por projeto, somando os manuais e os automáticos. Quando um novo fica pronto e o histórico está cheio, o mais antigo sai.Um backup por vez em cada projeto: enquanto um está sendo feito, o botão espera ele terminar. Um backup manual feito nas últimas 24 horas vale como a cópia do dia: o automático espera o dia seguinte e não tira o seu manual do histórico.
O que entra no backup
- Todos os arquivos da pasta do projeto, inclusive os que o seu app criou (um banco SQLite, uploads, logs), e as pastas vazias.
- Não entram:
node_modules,venv,.venv,__pycache__e.git, a pastavendorde um projeto PHP (com ocomposer.jsonna raiz), atalhos (links simbólicos) e arquivos especiais. - A configuração do projeto (nome, tipo, linguagem e versão, comando, arquivo principal, memória, porta, build e subdomínio) e as variáveis de ambiente não entram no
.zip, mas ficam guardadas junto do backup (as variáveis, cifradas), para o Restaurar como novo. Restaurar no mesmo projeto não mexe nelas: valem as do projeto.
Restaurar
- Na lista, abra o menu do backup e escolha Restaurar.
- Confirme. Se o projeto estava no ar, ele para.
- Os arquivos de agora são trocados pelos do backup. As dependências só são instaladas de novo se o
package.json, opackage-lock.jsonou orequirements.txtmudou. - O projeto fica parado. Confira os arquivos e clique em Iniciar quando quiser.
restore_no_space) ou o backup não abrir (invalid_backup), nada muda: os arquivos ficam como estavam e, se o projeto estava no ar, ele volta ao ar.
Se a resposta não chegar até o fim (a conexão caiu ou o servidor não respondeu no meio), não dá para saber se os arquivos já foram trocados, e o projeto fica parado. Confira os arquivos antes de iniciar ou restaure de novo.
O Histórico de envios (Configurações › Deploy) mostra cada restauração como “Backup restaurado”.
Restaurar como novo
O backup de um projeto apagado volta como um projeto novo, com outro ID: em Backups, abra o projeto com o selo Apagado, escolha a versão e clique em Restaurar como novo.- O projeto novo tem o código do backup, a configuração que o projeto tinha no momento do backup e as mesmas variáveis de ambiente (os valores voltam cifrados, sem aparecer em lugar nenhum). A confirmação diz o que aquele backup guardou.
- Num site, o subdomínio de antes volta se ainda estiver livre; se outro site já pegou, sai outro, como num envio novo.
- As dependências são instaladas de novo e o projeto fica parado: confira e clique em Iniciar.
- Vale como criar um projeto: precisa caber no plano (quantos projetos e a memória), a conta não pode estar suspensa, e a memória sobe até o mínimo do plano de agora, se estava abaixo.
- O backup continua lá até vencer: dá para restaurar de novo.
cube.json do .zip e voltam sem as variáveis de ambiente: adicione de novo antes de iniciar. Sem o cube.json, a Cube não sabe como iniciar o projeto (missing_config): baixe o backup e envie o .zip pelo Novo projeto, que pergunta a linguagem e o comando.
O banco de dados apagado volta do mesmo jeito, como um banco novo: veja Bancos de dados.
Excluir o projeto
Excluir o projeto (Configurações › Geral › Zona de perigo) apaga os arquivos, a configuração e os logs, mas os backups ficam na página Backups por até 30 dias, para baixar ou restaurar como novo. Eles seguem a regra de sempre: nenhum passa da validade, e o mais antigo sai primeiro. Somando todos os projetos apagados, a conta guarda os backups manuais e automáticos mais recentes até o número do plano (o mesmo de cada projeto: 1 no Free, 5 no Stack); as cópias Antes da suspensão e Antes de apagar não entram nessa conta.Suspensão da conta
Quando os projetos param por falta de pagamento ou no fim do beta, cada projeto ganha uma cópia Antes da suspensão, que fica 30 dias como as outras e não conta no limite do plano. Um projeto que continua parado e é apagado depois de 30 dias ganha antes uma cópia Antes de apagar. Ela fica mais 30 dias depois de o projeto sumir, e você baixa ou restaura como novo em Backups, na barra lateral.Pela API
Com uma chave de API você lista, faz e baixa backups (bom para guardar uma cópia no seu próprio armazenamento). Listar pede a permissãobackups:read; fazer, baixar e restaurar pedem backups:write, porque o .zip traz o .env e os outros arquivos com segredo:
- Listar backups e Fazer backup;
- Pedir o link de download e Baixar o backup;
- Restaurar um backup no mesmo projeto;
- Listar os backups da conta (também os de projeto apagado, com
backups:read) e Restaurar como novo (backups:write).

