Problemas comuns
Todo erro vem com um código estável, uma mensagem e, quase sempre, uma dica. A lista completa, em inglês, está em errors.md. Aqui vão os que mais aparecem.
not logged in / unauthorized
Você ainda não entrou nesta máquina, ou o token expirou ou foi revogado.
Rode rapadura login.
not_invited
Seu usuário do GitHub ainda não foi convidado. Mande o usuário para o administrador e tente de novo depois do convite.
login_unavailable
O login pelo GitHub está desligado no gateway no momento. Peça um token ao
administrador e use RAPADURA_TOKEN, ou aguarde.
slug_taken, slug_reserved, invalid_slug
O nome já existe, é reservado ou tem caractere inválido. Use letras minúsculas, dígitos e hifens simples, e escolha outro nome. Veja Regras e limites.
archive_forbidden_file
A pasta tem arquivo que não pode subir: código de servidor (.php e
similares) ou segredos (.env, chaves). A mensagem lista cada um. Publique
só a pasta de saída do build, ou remova os arquivos. Não existe opção para
forçar.
archive_too_large / quota_exceeded
Passou do tamanho ou do número de sites. rapadura zones mostra os limites.
Reduza, apague um site antigo ou peça mais ao administrador.
publish_failed
O servidor recusou a configuração ou a verificação pós-publicação falhou. A versão anterior continua no ar. Tente de novo; se persistir, mande a mensagem completa ao administrador.
O site não abre em HTTPS logo depois de publicar
A primeira visita a um endereço novo emite o certificado e pode levar de 5 a
15 segundos. Recarregue. Se depois de um minuto ainda falhar, confira
rapadura sites show <nome> e avise o administrador.
"command not found: rapadura"
O instalador coloca o binário em ~/.local/bin. Adicione ao PATH
(export PATH="$HOME/.local/bin:$PATH" no seu .bashrc/.zshrc) ou chame
pelo caminho completo. No Windows, veja Começando.
O agente diz que não encontra o servidor MCP
Garanta que rapadura está no PATH que o agente usa, ou registre com o
caminho completo do binário. Teste no terminal: rapadura whoami tem que
funcionar antes de o MCP funcionar.
Quero o site de volta depois de apagar
Os arquivos ficam guardados por um tempo. Peça ao administrador para restaurar; informe o endereço completo.