Guía rápida y práctica para instalar Docker, ejecutar la imagen n8nio/n8n, resolver problemas comunes y poner n8n detrás de Nginx con certificado de Lets Encrypt. En producción usa siempre HTTPS y no desactives las cookies seguras salvo para pruebas locales rápidas.
Qué necesitas antes Una VPS Ubuntu 20.04 o 22.04, un dominio con registro A apuntando a la IP de tu VPS, un usuario con sudo o root, Docker instalado y nociones básicas de línea de comandos para copiar y pegar órdenes.
1. Instalar Docker de forma fiable Si te aparecen errores de paquetes como docker-ce has no installation candidate, usa el script oficial de Docker. Comandos sudo apt remove docker docker-engine docker.io containerd runc -y sudo apt update && sudo apt upgrade -y curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh docker --version sudo docker run hello-world Si hello-world imprime el mensaje de bienvenida, Docker quedó correcto.
2. Comprobar imágenes y contenedores Comandos útiles docker image ls docker ps docker ps -a docker logs n8n docker rm -f n8n Si docker ps no muestra nada, no hay contenedores en ejecución. Si un contenedor aparece como Exited 1, revisa los logs para ver el error.
3. Preparar almacenamiento persistente y permisos n8n guarda los datos en la ruta interna del contenedor home node .n8n. En el host la mapearemos a la carpeta ~/.n8n y daremos permisos adecuados. Comandos mkdir -p ~/.n8n sudo chown -R 1000:1000 ~/.n8n El uid y gid 1000 1000 suele ser el usuario node en la imagen de n8n y permite escritura.
4. Ejecutar n8n de forma simple Comando recomendado docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n Comprueba con docker ps que el estado sea Up y que el puerto esté mapeado correctamente, por ejemplo 0.0.0.0:5678 a 5678 tcp.
5. Problemas frecuentes y soluciones a. Conflicto de nombre en docker run Lista y elimina el contenedor previo docker ps -a docker rm -f nombre_o_id b. El contenedor inicia y se apaga enseguida Exited 1 Revisa logs con docker logs nombre_o_id Causas típicas Permisos en la carpeta ~/.n8n soluciona con sudo chown -R 1000:1000 ~/.n8n Puerto en uso revisa con sudo lsof -i -P -n | grep LISTEN o cambia el mapeo a -p 8080:5678 Variables de entorno de base de datos incompletas si configuraste una. c. Errores de repositorio o imagen no encontrada Instala Docker con el script get.docker.com del paso 1 para evitar repos mal configurados.
6. Proteger n8n con Nginx y HTTPS recomendado n8n usa cookies seguras por defecto y puede advertir si accedes por HTTP. La mejor práctica es situarlo detrás de Nginx con certificado TLS. Configuración básica de Nginx Crea el archivo etc nginx sites-available n8n.conf con este contenido server { listen 80; server_name yourdomain.com; location / { proxy_pass https://127.0.0.1:5678; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } Habilita y prueba sudo ln -s /etc/nginx/sites-available/n8n.conf /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl restart nginx Certificado TLS con Certbot sudo apt install certbot python3-certbot-nginx -y sudo certbot --nginx -d yourdomain.com --non-interactive --agree-tos -m your-email@example.com Accede por https yourdomain.com y desaparecerán los avisos de cookies seguras. Importante no establezcas N8N_SECURE_COOKIE=false en producción. Solo considera desactivarlo para pruebas locales temporales.
7. Añadir autenticación básica opcional Para una capa extra de protección en n8n docker rm -f n8n docker run -d --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n -e N8N_BASIC_AUTH_ACTIVE=true -e N8N_BASIC_AUTH_USER=admin -e N8N_BASIC_AUTH_PASSWORD=StrongPasswordHere n8nio/n8n Con Nginx mas HTTPS mas Basic Auth tendrás una seguridad notablemente mejor.
8. Ejemplo con Docker Compose opcional Archivo docker-compose.yml mínimo que puedes ampliar después version: 3.8 services: n8n: image: n8nio/n8n container_name: n8n ports: - 5678:5678 environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=StrongPasswordHere volumes: - ~/.n8n:/home/node/.n8n restart: unless-stopped Ejecuta con docker compose up -d.
Cómo despliego n8n en una VPS con Docker, Nginx y HTTPS En Q2BSTUDIO somos expertos en despliegues productivos, automatización de procesos y orquestación en contenedores. Si tu objetivo es construir flujos robustos y conectar tus sistemas con n8n, podemos ayudarte a diseñar una arquitectura segura, escalable y lista para producción, incorporando monitorización, copias de seguridad y despliegues continuos. Nuestro equipo desarrolla aplicaciones a medida y software a medida, integra sistemas con APIs, y añade inteligencia artificial para potenciar la automatización con agentes IA y modelos avanzados, siempre con foco en ciberseguridad, cumplimiento y gobierno del dato.
Además de la configuración de Nginx y certificados, trabajamos con servicios cloud aws y azure para que tus flujos funcionen de forma confiable, con balanceo de carga, alta disponibilidad y observabilidad. Si quieres impulsar la automatización de procesos en tu organización, descubre cómo podemos ayudarte desde nuestra página de automatización de procesos. Y si buscas una estrategia integral en la nube para crecer con resiliencia y costes optimizados, explora nuestros servicios cloud aws y azure.
Palabras clave para reforzar tu estrategia digital aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi, automatización de procesos. Si además necesitas cuadros de mando, reporting avanzado y analítica, podemos integrar n8n con pipelines de datos y soluciones de inteligencia de negocio basadas en Power BI, garantizando trazabilidad y seguridad de extremo a extremo.
Consejos finales usa HTTPS en producción, actualiza Docker y tu sistema con regularidad, mantén copias de seguridad de ~/.n8n o de tu base de datos externa, monitoriza contenedores y recursos, y evita desactivar las cookies seguras en entornos públicos. Con estos pasos tendrás un despliegue de n8n sólido, seguro y listo para crecer.