Terminal Web

Accede a tu servidor directamente desde el navegador sin necesidad de configurar SSH en tu computadora.

Acceder a la Terminal

1. Ve a tu Dashboard y selecciona un deployment
2. En la sección "Herramientas Avanzadas", haz clic en "Terminal"
3. La terminal se abrirá en una ventana modal

Conexión Automática

La terminal se conecta automáticamente usando las credenciales de tu deployment. No necesitas recordar contraseñas.

Botón de Ayuda

En la esquina superior del modal verás un botón de ayuda (?) que te trae directamente a esta documentación.

Tipos de Conexión

La terminal te permite conectarte a dos lugares diferentes:

Host (VPS)

Conexión directa al servidor. Tienes acceso completo al sistema:

• Ver todos los contenedores con docker ps
• Modificar archivos del sistema
• Instalar paquetes
• Reiniciar servicios

Contenedores Individuales

Conexión dentro de un contenedor específico. Útil para:

• Debugging de la aplicación
• Ver archivos dentro del contenedor
• Ejecutar comandos específicos de la app
• Acceder a la consola de la aplicación

Cómo Seleccionar el Destino

Cuando abres la terminal, verás un dropdown en la parte superior:

Conectar a: [🖥️ Host (VPS)     ▼]

El dropdown incluye:

• 🖥️ Host (VPS): Acceso completo al servidor
• 📦 n8n_app: Contenedor de la aplicación
• 📦 n8n_db: Contenedor de la base de datos
• 📦 redis: Contenedor de cache (si aplica)

Simplemente selecciona el destino del dropdown. La terminal se reconectará automáticamente.

Cuando seleccionas un contenedor, verás un badge que muestra el comando ejecutado:

docker exec -it n8n_app

Contenedores Disponibles

Los contenedores que ves dependen de tu aplicación. Por ejemplo:

• n8n: n8n_app, n8n_db, redis
• WordPress: wordpress_app, wordpress_db
• Ghost: ghost_app, ghost_db

Cuándo Usar Cada Uno

Usa el Host cuando necesites:

• Ver el estado general del servidor
• Reiniciar Docker o la aplicación completa
• Modificar configuración del sistema
• Ver logs de Docker
• Gestionar espacio en disco

Usa un Contenedor cuando necesites:

• Debuggear problemas de la aplicación
• Acceder a la consola de comandos de la app
• Ver archivos internos del contenedor
• Ejecutar scripts de la aplicación

Comandos Útiles

En el Host (VPS)

# Ver todos los contenedores
docker ps

# Ver logs de toda la aplicación
docker compose logs -f --tail=100

# Reiniciar la aplicación
docker compose restart

# Ver uso de disco
df -h

# Ver uso de memoria
free -h

# Ver procesos activos
htop

Dentro de un Contenedor

# Ver archivos de la app
ls -la /app

# Ver variables de entorno
env

# Buscar un archivo
find / -name "archivo.txt"

# Ver procesos del contenedor
ps aux

Comandos por Aplicación

n8n

# Ya estás en el contenedor n8n_app
# Ver workflows
ls -la /home/node/.n8n/

# Ver configuración
cat /home/node/.n8n/config

WordPress

# En el contenedor wordpress_app
# Usar WP-CLI
wp core version
wp plugin list
wp user list

PostgreSQL

# En el contenedor de base de datos
psql -U postgres
\l   # Listar bases de datos
\dt  # Listar tablas

Atajos de Teclado

Atajo	Acción
Ctrl + C	Cancelar comando actual
Ctrl + L	Limpiar pantalla
Ctrl + D	Cerrar sesión
Tab	Autocompletar
↑ / ↓	Navegar historial

Navegación de Archivos (Host)

# Ir a la carpeta de la app
cd /app

# Ver archivos
ls -la

# Ver contenido de archivo
cat docker-compose.yml

# Editar archivo (editor simple)
nano archivo.txt

Carpetas Importantes (Host)

Carpeta	Contenido
/app	Archivos de tu aplicación
/app/docker-compose.yml	Configuración de Docker
/app/.env	Variables de entorno
/opt/deployalo	Agente de Deployalo
/var/log	Logs del sistema

Solución de Problemas

La terminal no conecta

1. Verifica que tu deployment esté en estado "Running"
2. Espera unos segundos y recarga la página
3. Si persiste, reinicia el deployment desde el panel

"Container not found"

Si al seleccionar un contenedor ves este error:

1. El contenedor puede estar reiniciándose
2. Ve al Host y ejecuta docker ps para ver los nombres exactos
3. Si el contenedor no aparece, la app puede tener problemas

Comandos no responden

Si un comando se queda "colgado":

1. Presiona Ctrl + C para cancelar
2. Si no funciona, cierra y abre la terminal de nuevo

No hay bash en el contenedor

Algunos contenedores minimalistas (Alpine Linux) solo tienen sh:

# Si bash no está disponible, usa:
sh
# O:
/bin/sh

Error de permisos

En el Host: Todos los comandos se ejecutan como root. Si ves errores de permisos, puede ser un problema con los volúmenes de Docker:

# Ver permisos de un archivo
ls -la /app/data/

# Cambiar permisos si es necesario
chmod -R 755 /app/data/

En un Contenedor: Cada contenedor tiene su propio usuario. Algunos comandos pueden requerir root:

# Si necesitas root dentro del contenedor
# Cierra la terminal y conéctate al Host
# Luego:
docker exec -u root -it nombre_contenedor sh

Seguridad

Importante

La terminal tiene acceso completo al servidor o contenedor. Ten cuidado con los comandos que ejecutas:

• rm -rf puede borrar archivos importantes
• No compartas tu pantalla mientras uses la terminal
• Cierra la terminal cuando termines
• Los cambios en contenedores pueden perderse si se reinician

Diferencias Técnicas

Característica	Host (VPS)	Contenedor
Usuario	root	Usuario del contenedor
Persistencia	Permanente	Puede perderse al reiniciar
Alcance	Todo el servidor	Solo el contenedor
Docker	Disponible	No disponible
Sistema base	Ubuntu/Debian	Depende de la imagen

Limitaciones

• Timeout de sesión: 30 minutos de inactividad
• No soporta aplicaciones con interfaz gráfica
• Algunos caracteres especiales pueden no funcionar correctamente
• Cambiar de destino cierra la sesión actual