Solución de problemas y preguntas frecuentes
La mayoría de los tropiezos se arreglan en un paso. Busca tu síntoma aquí abajo, aplica la solución y el agente vuelve al trabajo. Lo que no esté aquí, llévalo a Soporte en el panel o a [email protected].
Mi vista previa dice que no hay nada escuchando en el puerto. ¿Qué pasa?
El servidor escucha en localhost o 127.0.0.1, donde la vista previa no puede llegar. Arráncalo en 0.0.0.0:
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
La vista Vistas previas del box marca los servidores que solo escuchan en localhost. Funcionan los puertos del 1024 al 65535. Si aún no corre nada en el puerto, el enlace responde en cuanto arranca un servidor. Más en Vistas previas y archivos.
El agente dice que no tiene sesión, o la fila de mi cuenta muestra «Sesión cerrada». ¿Cómo lo arreglo?
La suscripción perdió su sesión, y los boxes vinculados a ella se detienen hasta que reconectes. Abre Cuentas, elige Reconectar en la fila y vuelve a entrar en la misma cuenta. Todas las vinculaciones con boxes siguen en su sitio. Consulta Suscripciones.
Cambié la cuenta de un box, pero el agente sigue usando la anterior. ¿Por qué?
Un agente en marcha conserva la sesión con la que arrancó. Reinicia el agente en cada pestaña abierta después de cambiar de cuenta.
Una pestaña dice «Parado en el límite». ¿Y ahora qué?
La suscripción se agotó, y la fila muestra cuándo se reinicia. Tienes tres salidas:
- Activa Seguir cuando el límite se reinicie, y el box escribe «continue» en el minuto en que el límite se reinicia.
- Conecta una segunda cuenta y activa Rotar las suscripciones a medida que se agotan.
- En una cuenta de Codex con reinicios disponibles, elige Usar un reinicio en Cuentas.
Rotación explica las tres.
Una pestaña dice «Detenido para guardar tu reserva». ¿Cómo la dejo seguir?
La cuenta alcanzó la reserva que fijaste. Abre Cuentas, elige Guardar una reserva en la fila y baja los números. La cuenta vuelve a sus boxes en cuanto guardas.
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 del box a mi portátil?
No. Guarda un token de corta duración que solo se renueva para el box. Inicia sesión en Codex y en Claude por separado en tu portátil.
No aparece la entrada por voz en Firefox. ¿Por qué?
La entrada por voz usa el reconocimiento de voz del navegador, y Firefox no lo tiene. Usa Chrome, Edge o Safari. 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?
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. No se envía nada entre Desde y Hasta, en la zona horaria que muestra la página. La lista Terminales sigue mostrando cada agente que espera.
SSH dice «Permission denied (publickey)». ¿Qué pasa?
El box no recibió ninguna clave que conozca. Revisa tres cosas:
- La clave de tu ordenador está listada en Claves SSH. Añádela, o usa Importar desde GitHub.
- El usuario del comando es el nombre del box:
ssh [email protected]. - Pegaste el archivo público
.pub, no la clave privada.
SSH tiene todos los pasos.
Se rechazó el cambio a un plan más pequeño. ¿Por qué?
Los datos del box no caben en el disco más pequeño. El mensaje indica cuánto guarda el box y cuánto admite el plan más pequeño. Libera espacio dentro del box y vuelve a cambiar:
du -sh ~/* | sort -h
docker system df
En los planes Business, los snapshots también cuentan para el disco. Disco: archivos y snapshots, en Resumen, muestra el total.
Mi box se detuvo y dice que el pago no se completó. ¿He perdido mis datos?
No. Un box sin pagar se detiene el día 3 y se elimina el día 14. Paga antes y vuelve a arrancar con todos sus archivos. Elige Pagar ahora en la página del box, o actualiza la tarjeta en Gestionar la facturación. Consulta Facturación.
Mis sesiones tmux desaparecieron tras un reinicio del nodo. ¿Adónde fueron?
Un reinicio planificado conserva los archivos, las imágenes Docker y los volúmenes, y los boxes vuelven a arrancar solos. Los procesos en marcha y las sesiones tmux empiezan de cero, así que abre la terminal y vuelve a arrancar el agente. Los reinicios planificados se avisan por correo con 48 horas de antelación.
Una página que abrió el agente nunca apareció. ¿Por qué?
El navegador bloqueó la ventana emergente. Permite las ventanas emergentes para my.detachbox.com, y las siguientes páginas se abren solas. Para que las páginas se abran sin preguntar, activa Abrirlas solas en este navegador en Ajustes → Páginas que abre el agente.
No puedo abrir otra pestaña de terminal. ¿Por qué?
Un box tiene hasta 10 pestañas. Cierra una que ya no necesites, y el botón + abre una nueva. Cerrar una pestaña detiene todos los programas que corren en ella.
Al soltar una carpeta en la terminal, falla. ¿Cómo la subo?
La terminal no acepta carpetas. Comprime la carpeta y suelta el zip, o copia la carpeta con rsync por SSH:
rsync -az ./my-folder/ [email protected]:~/my-folder/
Los archivos sueltos pueden pesar hasta 50 MB, y las imágenes hasta 20 MB.
La página del box dice «La preparación se detuvo a medias». ¿Qué hago?
Restablece el box para repetir la preparación: Ajustes → Restablecer box. Si vuelve a detenerse, escribe a soporte con el nombre del box.