detachbox
PáginasSolución de problemas y preguntas frecuentes

Solución de problemas y preguntas frecuentes

Busca tu síntoma aquí abajo: la primera línea bajo cada uno es la solución, y la mayoría se arregla en un paso. Para lo que no esté aquí, escribe a Soporte en el panel o a support@detachbox.com.

Mi vista previa dice que no hay nada escuchando en el puerto. ¿Qué pasa?

Arranca el servidor en 0.0.0.0. En localhost o 127.0.0.1 la vista previa no llega a él:

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

Abre la vista previa desde el terminal que ejecuta el servidor: en Terminales, elige Archivos y vistas previas encima de él. La lista marca un servidor que solo escucha en localhost. Funcionan los puertos del 1024 al 65535. Más en URL de vista previa.

Una vista previa dice «Esta vista previa es privada». ¿Por qué?

Si el terminal es tuyo, elige Entrar con otra cuenta y entra con la que es su dueña: el enlace lleva a un terminal de una cuenta con la que este navegador no tiene la sesión iniciada. Para que otra persona pueda abrirlo, haz público el puerto.

El agente dice que no tiene sesión, o la fila de mi cuenta muestra «Sesión cerrada». ¿Cómo lo arreglo?

Abre Suscripciones y claves, elige Reconectar en la fila y vuelve a entrar en la misma cuenta. La suscripción perdió su sesión, y sus agentes esperan hasta que reconectes; todos los lanzamientos siguen con ella. Consulta Suscripciones.

Cambié la suscripción de un lanzamiento, pero el agente sigue usando la anterior. ¿Por qué?

Pulsa el nombre de la cuenta encima del terminal, escoge la cuenta nueva y elige Reiniciar en esta conversación cuando te lo pregunte. O abre un terminal nuevo del lanzamiento. Un terminal en marcha conserva la cuenta con la que arrancó hasta que su agente vuelve a arrancar.

Un terminal dice «Parado en el límite». ¿Y ahora qué?

Elige una de estas tres soluciones; la fila muestra cuándo se reinicia la suscripción:

  • Marca Seguir cuando el límite se reinicie en el lanzamiento, y detachbox escribe «continue» en el minuto en que el límite se reinicia.
  • Conecta una segunda cuenta y marca Rotar las suscripciones a medida que se agotan en el lanzamiento.
  • En una cuenta de Codex con reinicios disponibles, elige Usar un reinicio en Suscripciones y claves.

Seguir cuando el límite se reinicie y Rotación explican las dos primeras.

Un terminal dice «Detenido para guardar tu reserva». ¿Cómo lo dejo seguir?

Abre Suscripciones y claves, elige Guardar una reserva en la fila y luego Suspender reserva hasta 20:00, que indica la hora a la que se reinicia la semana. La cuenta vuelve a sus lanzamientos al momento, y la reserva vuelve sola tras el reinicio. O elige Cambiar de suscripción en el aviso sobre el terminal.

El agente se detuvo porque el Compute se quedó sin memoria. ¿Qué hago?

Elige Reiniciar terminal en el aviso, y el agente retoma su conversación. Tus terminales juntos necesitaron más memoria de la que tiene tu tamaño, así que el sistema detuvo el programa más grande. Si sigue pasando, para los contenedores que no necesites o elige Cambiar tamaño para tener más memoria. CPU, memoria y disco tiene más.

Un terminal se quedó sin procesos y no arranca nada en él. ¿Por qué?

Elige Reiniciar terminal para tener un contenedor nuevo, y pon init: true en ese servicio de tu archivo compose. Un programa del terminal lanzó procesos y nunca los recogió al terminar, hasta ocupar los 32 768; el aviso nombra el programa cuando puede.

Codex no se conecta. OpenAI rechaza el código.

Activa primero el inicio de sesión con código de dispositivo. En ChatGPT, abre Settings → Security y activa la autorización con código de dispositivo para Codex. Después elige Pedir un código nuevo en el diálogo. Un código caduca a los 15 minutos.

¿Puedo copiar auth.json de mi Compute a mi portátil?

No: inicia sesión en Codex y en Claude por separado en tu portátil. Ese archivo solo guarda un access token, y nuestro servidor lo renueva únicamente para detachbox.

Pegar una captura no hace nada. ¿Por qué?

Permite el acceso al portapapeles para my.detachbox.com en los ajustes del sitio (el icono a la izquierda de la dirección) y vuelve a pegar: el navegador lo bloquea para el sitio. En el primer pegado, busca la solicitud del navegador junto a la barra de direcciones.

Una foto de mi iPhone no se subió. ¿Por qué?

Elígela desde Fotos en lugar de Archivos, o guárdala antes como JPEG, y vuelve a enviarla con Pegar una foto. El navegador no pudo convertirla a un formato que lean los agentes, y el terminal nombró la foto.

No aparece la entrada por voz en Firefox. ¿Por qué?

Usa Chrome, Edge o Safari: la entrada por voz funciona con el reconocimiento de voz del navegador, y Firefox no lo tiene. Si el dictado se detiene al instante, permite el micrófono para my.detachbox.com en los ajustes del sitio.

No me llegan los avisos push en el iPhone. ¿Cómo los activo?

Añade detachbox a la pantalla de inicio: en un iPhone, Safari solo envía avisos a la app de la pantalla de inicio. Abre my.detachbox.com en Safari, toca Compartir y luego Añadir a pantalla de inicio. Abre detachbox desde ese icono, ve a Notificaciones y elige Activar en este navegador. Después elige Enviar un aviso de prueba.

Los avisos dejaron de llegar de noche. ¿Están rotos?

Revisa Horas de silencio en Notificaciones. Entre Desde y Hasta, en la zona horaria que muestra la página, los eventos habituales no envían ningún aviso, ni por push, ni por Telegram, ni por correo. Los correos ya pendientes, y cualquier alerta de falta de memoria, esperan a que terminen las horas de silencio. La lista Terminales sigue mostrando cada agente que espera.

Se rechazó el cambio a un plan más pequeño. ¿Por qué?

Libera espacio y vuelve a cambiar. Lo que guardas, contado a tamaño completo, no cabe en el disco más pequeño; el mensaje indica cuánto guarda tu Compute, proyectos incluidos, y cuánto admite el tamaño más pequeño. Encuentra las carpetas más grandes con:

du -sh --apparent-size ~/* /work/* | sort -h

Mi Compute se detuvo y dice que el pago no se completó. ¿He perdido mis datos?

No. Paga la factura pendiente en Facturación antes del día 14 y vuelves a tener tus archivos. Tu Compute queda suspendido desde el día 3 tras el pago fallido, y el disco de la cuenta con tus proyectos y carpetas personales se mantiene hasta el día 14.

Mis sesiones tmux desaparecieron tras un reinicio del nodo. ¿Adónde fueron?

Abre el terminal: el agente ya ha vuelto a la conversación que tenía y espera tu siguiente palabra. Un reinicio del nodo termina todos los procesos en marcha y las sesiones tmux. Tus terminales vuelven solos, con sus paquetes, imágenes Docker y archivos, y tus proyectos y carpetas personales siguen en el disco de la cuenta. Los contenedores Docker con una política restart: vuelven a arrancar solos. Un terminal iniciado o reiniciado en los 15 minutos anteriores al reinicio del nodo vuelve sin su agente: Reiniciar el terminal en esta conversación lo trae de vuelta en esa conversación.

Un terminal que dejé se cerró solo. ¿Por qué?

Abre un terminal nuevo para continuar: tus archivos del proyecto y de su carpeta personal siguen ahí. Un terminal sin ningún agente en marcha y sin nadie en él durante 3 horas se cierra para liberar su plaza, y Actividad muestra cuándo.

Una página que abrió el agente nunca apareció. ¿Por qué?

Permite las ventanas emergentes para my.detachbox.com: el navegador la bloqueó. Para que las vistas previas se abran sin preguntar, activa Abrir las vistas previas solas en este navegador en Ajustes → Terminal → Páginas que abre el agente. Una página de otro sitio se abre sola en cuanto permites siempre su host desde el aviso del terminal.

Los tests de Go fallan con «no such file or directory» para archivos que están junto al test. ¿Por qué?

Desactiva el valor por defecto para el proyecto con go env -w GOFLAGS= en su terminal (un valor vacío lo anula), o define GOFLAGS en el entorno. Go compila en tus terminales con -trimpath, así que su caché de compilación guarda una copia de cada paquete en lugar de una por cada ruta de worktree de un agente. Con -trimpath, runtime.Caller no devuelve ningún directorio, y un test que abre archivos a su lado a través de él busca en el sitio equivocado.

No puedo abrir otro terminal. ¿Por qué?

Finaliza uno que ya no necesites con × en su barra y Nueva terminal abrirá uno nuevo, o sube de plan con Cambiar plan. Tu tamaño fija cuántos terminales corren a la vez: 3 en Start, 5 en Pro, 8 en Max, 10 en Business, 15 en Business Plus, 20 en Business Max, 30 en Business Ultra. Finalizar un terminal detiene todos los programas que corren en él. Tras pasar a un tamaño menor, los terminales ya abiertos siguen en marcha, y se abre uno nuevo cuando quedas por debajo del nuevo límite.

Al soltar una carpeta en el terminal, falla. ¿Cómo la subo?

Comprime la carpeta en zip y suelta el zip, o selecciona los archivos que contiene y suelta esos. Pasan archivos hasta el límite de tu plan: 100 MB en Start, hasta 10 GB en Business Ultra.

Se me cortó la conexión a mitad de una subida. ¿Empiezo de nuevo?

No. La subida espera la conexión y sigue desde la última parte que llegó al terminal; mientras tanto, el terminal muestra «Se perdió la conexión. Seguimos donde se quedó…». En cuanto vuelves a tener conexión, sigue al momento. Si el terminal sigue fuera de alcance unos quince minutos, la subida se detiene y te lo dice: suelta el archivo de nuevo.

Mi archivo es demasiado grande para subirlo. ¿Qué hago?

Comprime o divide el archivo y suelta las partes, o sube de plan con Cambiar plan. Tu plan fija el archivo más grande que puedes soltar: 100 MB en Start, 250 MB en Pro, 500 MB en Max, 1 GB en Business, 2 GB en Business Plus, 5 GB en Business Max, 10 GB en Business Ultra.

Los paquetes que instalé con sudo han desaparecido. ¿Por qué?

Guarda en /home/dev las herramientas que necesitas siempre, por ejemplo un binario en ~/.local/bin o un paquete de npm i -g, y todos los terminales de ese proyecto las tendrán. Un paquete instalado con sudo vive en el terminal que lo instaló y se va con él, o con su reinicio; cada terminal nuevo arranca desde la imagen actual.

Las escrituras fallan con «No space left on device». ¿Y ahora qué?

Haz clic en los medidores de recursos de la barra superior y elige Vaciar cachés bajo el disco: vacía a la vez las cachés de paquetes y de compilación de todas las carpetas personales. Tus proyectos y tus carpetas personales llenaron el disco de la cuenta, así que encuentra el resto con du -sh --apparent-size ~/* /work/* | sort -h en el terminal de un proyecto (~ es la carpeta personal de ese proyecto) y borra lo que ya no necesites. O elige un tamaño mayor con Cambiar plan en Compute: un disco mayor se aplica al instante.

En un proyecto ya no tengo mi sesión de git ni gh. ¿Por qué?

Inicia sesión una vez en el terminal de ese proyecto, y la tendrán todos los terminales del proyecto. Cada proyecto tiene su propia carpeta personal, así que los inicios de sesión, las claves y los ajustes de las herramientas viven con el proyecto, y tus otros proyectos nunca los ven.

Un proyecto dice «Preparación detenida». ¿Qué hago?

Corrige la dirección o la carpeta ahí mismo, en la página del proyecto, y pulsa Reintentar: el mismo proyecto se prepara de nuevo desde lo que indiques. El mensaje de debajo dice por qué falló el clonado o la copia: a menudo una dirección mal escrita o un repositorio privado sin sesión de git. Para un repositorio privado, inicia antes sesión en git en un terminal de shell: gh auth login o glab auth login.