Solução de problemas e FAQ
Encontre o seu sintoma abaixo: a primeira linha embaixo dele é a solução, e a maioria das soluções leva um passo. Para o que não estiver aqui, escreva para o Suporte no painel ou para support@detachbox.com.
Meu preview diz que nada está escutando na porta. O que está errado?
Inicie o servidor em 0.0.0.0. Em localhost ou 127.0.0.1, o preview não o alcança:
npm run dev -- --host 0.0.0.0
vite --host 0.0.0.0
next dev -H 0.0.0.0
rails s -b 0.0.0.0
uvicorn app:app --host 0.0.0.0
Abra o preview pelo terminal que roda o servidor: em Terminais, escolha Arquivos e prévias acima dele. A lista avisa quando um servidor escuta só em localhost. Portas de 1024 a 65535 funcionam. Mais em URLs de preview.
Um preview diz "Este preview é privado". Por quê?
Se o terminal é seu, escolha Entrar com outra conta e entre com a conta dona dele: o link leva a um terminal de uma conta em que este navegador não está logado. Para deixar outra pessoa abrir, torne a porta pública.
O agente diz que perdeu o login, ou a linha da minha conta mostra "Login perdido". Como resolvo?
Abra Assinaturas e chaves, escolha Reconectar na linha e entre de novo na mesma conta. A assinatura perdeu o login, e os agentes dela esperam até você reconectar; todas as inicializações continuam nela. Veja Assinaturas.
Troquei a assinatura de uma inicialização, mas o agente ainda usa a antiga. Por quê?
Clique no nome da conta acima do terminal, escolha a conta nova e escolha Reiniciar nesta conversa quando ele perguntar. Ou abra um terminal novo da inicialização. Um terminal aberto fica na conta com que começou até o agente dele iniciar de novo.
Um terminal diz "Parou no limite". E agora?
Escolha uma das três soluções; a linha mostra quando a assinatura renova:
- Marque Continuar quando o limite renovar na inicialização, e o detachbox digita "continue" no minuto em que o limite renova.
- Conecte uma segunda conta e marque Alternar as assinaturas à medida que se esgotam na inicialização.
- Numa conta do Codex com resets sobrando, escolha Usar um reset em Assinaturas e chaves.
Continuar quando o limite renovar e Alternância explicam os dois primeiros.
Um terminal diz "Parado para manter a sua margem". Como faço ele voltar a rodar?
Abra Assinaturas e chaves, escolha Manter uma margem na linha e depois Suspender margem até 20:00, que mostra o horário em que a semana renova. A conta volta na hora para as inicializações dela, e a margem volta sozinha depois da renovação. Ou escolha Trocar de assinatura no aviso acima do terminal.
O agente foi parado porque o Compute ficou sem memória. O que eu faço?
Escolha Reiniciar terminal no aviso, e o agente retoma a conversa. Os seus terminais, somados, precisaram de mais memória do que o plano oferece, então o sistema parou o maior programa. Se continuar acontecendo, pare os contêineres de que você não precisa ou escolha Mudar tamanho para ter mais memória. CPU, memória e disco tem mais detalhes.
Um terminal ficou sem processos e nada inicia nele. Por quê?
Escolha Reiniciar terminal para ter um contêiner novo e ponha init: true nesse serviço no seu arquivo compose. Um programa no terminal iniciou processos e nunca os recolheu quando terminaram, até ocupar todos os 32.768; o aviso identifica o programa quando consegue.
O Codex não conecta. A OpenAI recusa o código.
Ative antes o login por código de dispositivo. No ChatGPT, abra Settings → Security e ative a autorização por código de dispositivo para o Codex. Depois escolha Gerar novo código na janela. Um código expira depois de 15 minutos.
Posso copiar o auth.json do meu Compute para o meu notebook?
Não: faça login no Codex e no Claude no seu notebook separadamente. Esse arquivo guarda só um access token, e o nosso servidor o renova apenas para o detachbox.
Colar um print não faz nada. Por quê?
Libere o acesso à área de transferência para my.detachbox.com nas configurações do site (o ícone à esquerda do endereço) e cole de novo: o navegador está bloqueando esse acesso para o site. Na primeira colagem, procure o pedido do navegador junto à barra de endereço.
Uma foto do meu iPhone não subiu. Por quê?
Escolha a foto em Fotos em vez de Arquivos, ou salve-a antes como JPEG, e mande de novo com Colar uma foto. O navegador não conseguiu convertê-la para um formato que os agentes leem, e o terminal disse qual foi a foto.
A entrada por voz não aparece no Firefox. Por quê?
Use o Chrome, o Edge ou o Safari: a entrada por voz roda no reconhecimento de fala do navegador, e o Firefox não tem esse recurso. Se o ditado parar logo de cara, permita o microfone para my.detachbox.com nas configurações do site.
Não recebo avisos por push no iPhone. Como ativo?
Adicione o detachbox à Tela de Início: no iPhone, o Safari só manda avisos para o app da Tela de Início. Abra my.detachbox.com no Safari, toque em Compartilhar e depois em Adicionar à Tela de Início. Abra o detachbox por esse ícone, vá em Notificações e escolha Ativar neste navegador. Depois escolha Enviar notificação de teste.
Os avisos pararam de chegar à noite. Quebraram?
Confira o Horário silencioso em Notificações. Entre De e Até, no fuso horário mostrado na página, os eventos de rotina não mandam aviso nenhum por push, Telegram ou e-mail. Os e-mails que já estavam pendentes, e qualquer alerta de falta de memória, esperam o fim do horário silencioso. A lista Terminais continua mostrando cada agente que espera.
A troca para um plano menor foi recusada. Por quê?
Libere espaço e tente a troca de novo. O que você guarda, contado em tamanho real, não cabe no disco menor; a mensagem diz quanto o seu Compute guarda, projetos incluídos, e quanto cabe no tamanho menor. Encontre as maiores pastas com:
du -sh --apparent-size ~/* /work/* | sort -h
Meu Compute parou e diz que o pagamento não entrou. Perdi meus dados?
Não. Pague a fatura em aberto em Cobrança antes do dia 14 e você volta aos seus arquivos. Seu Compute fica suspenso a partir do dia 3 depois do pagamento que falhou, e o disco da conta com seus projetos e pastas pessoais continua lá até o dia 14.
Minhas sessões tmux sumiram depois de uma reinicialização do nó. Para onde foram?
Abra o terminal: o agente já voltou na conversa que tinha, esperando a sua próxima palavra. Um reinício do nó encerra todos os processos em execução e as sessões tmux. Seus terminais voltam sozinhos, com os pacotes, as imagens Docker e os arquivos, e seus projetos e pastas pessoais continuam no disco da conta. Contêineres Docker com uma política restart: sobem de novo sozinhos. Um terminal iniciado ou reiniciado nos 15 minutos antes do reinício volta sem o agente: Reiniciar o terminal nesta conversa o traz de volta nessa conversa.
Um terminal que deixei de lado terminou sozinho. Por quê?
Abra um terminal novo para seguir: os seus arquivos no projeto e na pasta pessoal dele estão todos lá. Um terminal sem agente rodando e sem ninguém nele por 3 horas termina para liberar a vaga, e Atividade mostra quando.
Uma página que o agente abriu nunca apareceu. Por quê?
Permita pop-ups para my.detachbox.com: o navegador bloqueou a página. Para os previews abrirem sem perguntar, ligue Abrir previews sozinhos neste navegador em Configurações → Terminal → Páginas que o agente abre. Uma página em outro site abre sozinha depois que você escolhe sempre permitir o host dela no aviso do terminal.
Os testes Go falham com "no such file or directory" para arquivos ao lado do teste. Por quê?
Desligue o padrão no projeto com go env -w GOFLAGS= no terminal dele (um valor vazio sobrescreve), ou defina GOFLAGS no ambiente. O Go nos seus terminais compila com -trimpath, para que o cache de compilação guarde uma cópia de cada pacote, e não uma por caminho de worktree de agente. Com -trimpath, o runtime.Caller não devolve diretório, e um teste que abre arquivos ao lado de si mesmo por ele procura no lugar errado.
Não consigo abrir outro terminal. Por quê?
Encerre um de que você não precisa mais com o × na barra dele, e Novo terminal abre um novo, ou suba de tamanho com Mudar plano. O seu tamanho define quantos terminais rodam ao mesmo tempo: 3 no Start, 5 no Pro, 8 no Max, 10 no Business, 15 no Business Plus, 20 no Business Max, 30 no Business Ultra. Encerrar um terminal encerra todos os programas dentro dele. Depois de passar para um tamanho menor, os terminais já abertos continuam rodando, e um novo abre quando você fica abaixo do novo limite.
Soltar uma pasta no terminal falha. Como faço o upload?
Compacte a pasta e solte o zip, ou selecione os arquivos dentro dela e solte esses. Passam arquivos até o limite do seu plano: 100 MB no Start, até 10 GB no Business Ultra.
A conexão caiu no meio de um envio. Preciso começar de novo?
Não. O envio espera a conexão e continua da última parte que chegou ao terminal; enquanto isso, o terminal mostra "A conexão caiu. Continuando de onde parou…". Assim que você volta a ficar on-line, ele segue na hora. Se o terminal ficar fora de alcance por uns quinze minutos, o envio para e avisa: solte o arquivo de novo.
Meu arquivo é grande demais para enviar. O que faço?
Compacte ou divida o arquivo e solte as partes, ou suba de tamanho com Mudar plano. O seu plano define o maior arquivo que você pode soltar: 100 MB no Start, 250 MB no Pro, 500 MB no Max, 1 GB no Business, 2 GB no Business Plus, 5 GB no Business Max, 10 GB no Business Ultra.
Os pacotes que instalei com sudo sumiram. Por quê?
Guarde as ferramentas de que você precisa sempre em /home/dev, por exemplo um binário em ~/.local/bin ou um pacote do npm i -g, e todo terminal desse projeto as terá. Um pacote instalado com sudo vive no terminal que o instalou e vai embora com ele, ou com o reinício dele; todo terminal novo começa da imagem atual.
As gravações falham com "No space left on device". E agora?
Clique nos medidores de recursos da barra superior e escolha Limpar caches abaixo do disco: ele esvazia os caches de pacotes e de build de todas as pastas pessoais de uma vez. Seus projetos e as pastas pessoais encheram o disco da conta, então encontre o resto com du -sh --apparent-size ~/* /work/* | sort -h no terminal de um projeto (~ é a pasta pessoal desse projeto) e apague o que não precisa mais. Ou escolha um tamanho maior com Mudar plano em Compute: um disco maior vale na hora.
Meu login do git ou do gh sumiu num projeto. Por quê?
Faça login uma vez no terminal desse projeto, e todos os terminais do projeto passam a ter esse login. Cada projeto tem a própria pasta pessoal, por isso os logins, as chaves e as configurações das ferramentas ficam no próprio projeto, e seus outros projetos nunca os veem.
Um projeto diz "Preparação parada". O que eu faço?
Corrija o endereço ou a pasta na própria página do projeto e clique em Tentar de novo: o mesmo projeto é preparado outra vez a partir do que você indicar. A mensagem abaixo diz por que a clonagem ou a cópia falhou, muitas vezes um endereço digitado errado ou um repositório privado sem login no git. Para um repositório privado, entre antes no git num terminal de shell: gh auth login ou glab auth login.