Manuales y workflows

Yo he seguido este mismo proceso apoyándome todo el rato en Claude, el asistente de IA de Anthropic. No porque este manual esté incompleto, sino porque ningún manual, por bueno que sea, puede prever el error exacto que te va a salir a ti, en tu servidor, con tu configuración concreta.

Un manual te explica lo que pasó cuando yo lo hice. Un asistente de IA puede leer tu error, explicarte qué significa con otras palabras si la primera explicación no te ha quedado clara, y ayudarte a decidir el siguiente paso — a cualquier hora, sin esperar a que yo conteste un mensaje.

No sustituye a entender lo que haces. Pero sí quita esa sensación de estar solo delante de una pantalla negra que no te dice nada.

Hay varias opciones conocidas y todas te van a servir para seguir este manual sin problema. Sin entrar en cuál es "mejor" — porque sinceramente no lo sé, y cambia con el tiempo — esto es, a grandes rasgos, lo que te vas a encontrar:

• ChatGPT (OpenAI) — probablemente el más conocido y el que más gente ya ha probado alguna vez.
• Claude (Anthropic) — el que yo uso en este proyecto. Tiene una versión gratuita con límites de uso, igual que las demás.
• Gemini (Google) — viene integrado en varios productos de Google, cómodo si ya usas ese ecosistema.

Yo uso Claude simplemente porque es con el que más cómodo me siento — es una cuestión de gustos, parecida a elegir un editor de código o un sistema operativo. No es una recomendación de que sea mejor que las otras opciones para este manual: cualquiera de ellas te va a poder ayudar a explicar comandos, revisar errores y acompañarte capítulo a capítulo.

Elige uno, créate una cuenta gratuita si no la tienes, y déjalo abierto en una pestaña mientras avanzas por el resto del manual.

• Pega el error completo, no un resumen. Cuando algo falle, copia el mensaje entero de la terminal, no solo "no me funciona". Cuantos más detalles le des, mejor te va a poder ayudar.
• Pregunta antes de ejecutar, si no lo tienes claro. Si un comando te da respeto (sobre todo los de seguridad, como los del capítulo 01), pide que te lo explique antes de darle a Enter. "Antes de ejecutar esto, ¿qué hace exactamente?" es una pregunta perfectamente válida.
• Pide que te lo repita de otra forma. Si una explicación no te ha quedado clara, dilo. "No lo he entendido, explícamelo más despacio" siempre da mejor resultado que seguir adelante a medias.

Un ejemplo de mensaje que puedes usar tal cual cuando algo falle:

Estoy siguiendo un manual para montar mi propio stack de IA en un VPS.
Acabo de ejecutar este comando:
[pega aquí el comando exacto]

Y me ha devuelto este resultado o error:
[pega aquí el mensaje completo, tal cual]

¿Puedes explicarme en términos sencillos qué ha pasado
y qué debería hacer a continuación?

¿Qué es un VPS?

VPS son las siglas de "Servidor Privado Virtual". Piénsalo como un ordenador que no está en tu casa, sino en un centro de datos, encendido las 24 horas, al que tú accedes por internet para instalar y hacer funcionar lo que necesites. No tiene pantalla ni teclado propios: todo se hace escribiendo comandos en una ventana de texto llamada terminal.

Contratar el VPS

Yo uso IONOS porque es lo que ya conocía, pero esto funciona igual en Hetzner, DigitalOcean, Vultr, OVH o cualquier otro proveedor similar. Al contratarlo, elige:

• Sistema operativo: Ubuntu 24.04 LTS (la versión que uso en todo este manual).
• Un plan con al menos 4 GB de RAM si más adelante quieres usar ComfyUI u Ollama.
• Anota la dirección IP que te asignen — la necesitarás para conectarte.

Conectarte por primera vez (SSH)

SSH es el sistema que te permite abrir una terminal "dentro" de tu VPS desde tu propio ordenador, de forma segura. En Windows puedes usar la app Terminal o PowerShell; en Mac y Linux, la Terminal que ya viene instalada.

ssh root@tu-direccion-ip

Sustituye tu-direccion-ip por la IP real de tu VPS. La primera vez te pedirá confirmar la conexión (escribe yes) y después la contraseña que te dio tu proveedor.

Actualizar el sistema

Es lo primero que hago siempre en un VPS recién estrenado: ponerlo al día antes de instalar nada más.

sudo apt update && sudo apt upgrade -y

sudo significa "hazlo con permisos de administrador" — Ubuntu te lo pedirá para casi cualquier cambio importante en el sistema. Es normal y es lo esperado.

¿Por qué no trabajar siempre como "root"?

Cuando te conectas como root, tienes permiso para hacer literalmente cualquier cosa en el servidor — incluido borrar algo importante por error, sin que nadie te pregunte "¿seguro?". Por eso el primer paso de seguridad es crear un usuario normal para el día a día, y reservar los permisos de administrador solo para cuando de verdad los necesites.

adduser miusuario
usermod -aG sudo miusuario

El primer comando crea el usuario (te pedirá una contraseña). El segundo le da permiso para usar sudo, es decir, para poder pedir permisos de administrador puntualmente cuando haga falta.

Activar el firewall (cortafuegos)

Un firewall decide qué "puertas" de tu servidor están abiertas al exterior y cuáles cerradas. Ubuntu trae uno ya instalado, llamado UFW, que solo hay que activar con cuidado de no cerrarte tú mismo el acceso por SSH.

sudo ufw allow OpenSSH
sudo ufw enable
sudo ufw status

La primera línea deja abierta la puerta del SSH (para que no te quedes fuera de tu propio servidor). La segunda activa el firewall. La tercera te muestra qué reglas están activas.

El nombre de este proyecto es "Prueba y Error" por algo: vas a romper cosas. La diferencia entre que eso sea divertido o un disgusto serio está en tener una copia de seguridad reciente.

Snapshots del proveedor (la opción fácil)

Un snapshot es una "foto" completa de tu servidor en un momento concreto — sistema, archivos, todo — que tu proveedor guarda por ti y te permite restaurar con un par de clics si algo sale mal. Casi todos los proveedores (IONOS, Hetzner, DigitalOcean, Vultr...) lo ofrecen desde su panel web, normalmente en una sección llamada "Snapshots" o "Backups".

Te recomiendo activar la copia automática (semanal, por ejemplo) y además hacer una manual justo antes de cualquier cambio grande que vayas a probar.

Copia manual de tus archivos importantes

Además del snapshot completo, es buena costumbre guardar aparte las carpetas que más te importan (por ejemplo, esta misma web). El comando tar empaqueta y comprime una carpeta en un único archivo.

tar -czvf backup-$(date +%F).tar.gz /var/www

Esto crea un archivo con la fecha de hoy (por ejemplo backup-2026-07-20.tar.gz) con todo el contenido de /var/www. Puedes descargarlo a tu ordenador desde el propio panel de archivos de tu proveedor, o con un cliente SFTP.

¿Qué es Docker, en plata?

Imagina que cada programa que quieres instalar (n8n, ComfyUI, una base de datos...) viene dentro de su propia "caja cerrada" con absolutamente todo lo que necesita para funcionar: sus propias librerías, su propia configuración, sin pelearse con lo que ya tienes instalado en el servidor. Esa caja es un contenedor. Docker es el programa que crea, arranca y para esas cajas.

La ventaja práctica: si algo se rompe dentro de un contenedor, puedes borrarlo y volver a crearlo desde cero en segundos, sin que afecte a nada más de tu servidor.

Instalar Docker

Usamos el script oficial de instalación, que hace todo el trabajo por ti.

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

La primera línea descarga el instalador oficial; la segunda lo ejecuta. Tardará un par de minutos.

Comprobar que funciona

docker --version
docker compose version

Si ambos comandos responden con un número de versión (en vez de un error), Docker y Docker Compose están listos.

Un detalle útil: si quieres usar docker sin escribir sudo delante cada vez, puedes añadir tu usuario al grupo docker:

sudo usermod -aG docker $USER

Después de esto, cierra sesión y vuelve a conectarte por SSH para que el cambio surta efecto.

Para qué sirve Portainer

Docker se controla normalmente escribiendo comandos, y eso puede resultar incómodo al principio. Portainer es un panel visual — una página web — desde el que ves todos tus contenedores, sus registros de actividad ("logs"), puedes reiniciarlos o pararlos con un clic, sin memorizar comandos.

Lo curioso es que Portainer se instala también como un contenedor Docker más.

Instalar Portainer

docker volume create portainer_data

docker run -d \
  -p 8000:8000 -p 9443:9443 \
  --name portainer --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:lts

La primera línea crea un espacio donde Portainer guarda su propia configuración (un "volumen"). El bloque siguiente descarga Portainer y lo arranca, dejándolo accesible en el puerto 9443. Uso la etiqueta :lts en vez de :latest porque es lo que recomienda ahora mismo la documentación oficial de Portainer — una versión estable de soporte largo, en vez de la última versión sin más.

Acceder por primera vez

Abre en tu navegador: https://tu-direccion-ip:9443

El navegador probablemente avisará de que el certificado de seguridad no es de confianza — es normal en este primer acceso directo por IP, puedes continuar. Portainer te pedirá crear un usuario administrador y una contraseña la primera vez.

¿Qué hace Nginx aquí?

Cuando alguien visita tu dominio, esa visita llega a tu servidor "en bruto" — hay que decidir a qué servicio dirigirla (¿la web estática? ¿n8n? ¿otra cosa?) y, si usas HTTPS, quién gestiona el candado de seguridad. Ese trabajo de "recepcionista" lo hace Nginx: recibe todas las visitas al dominio y las reparte al sitio correcto dentro del servidor. A esto se le llama proxy inverso.

Instalar Nginx

sudo apt install nginx -y

Crear el archivo de configuración de tu dominio

Nginx guarda una configuración distinta para cada dominio que gestiona, en archivos separados. Crea uno nuevo con un editor de texto sencillo en la terminal:

sudo nano /etc/nginx/sites-available/tudominio.com

Y pega este contenido básico, cambiando tudominio.com por el tuyo:

server {
    listen 80;
    server_name tudominio.com www.tudominio.com;

    location / {
        proxy_pass http://localhost:3000;
    }
}

Guarda con Ctrl+O, luego Enter, y sal con Ctrl+X. El número 3000 es solo un ejemplo — más adelante lo cambiaremos según qué servicio quieras exponer.

Activar el sitio y comprobar errores

sudo ln -s /etc/nginx/sites-available/tudominio.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

nginx -t comprueba que no hay errores de sintaxis antes de aplicar nada — consulta siempre este paso antes de recargar. Si todo va bien, verás syntax is ok y test is successful.

Añadir HTTPS gratis con Certbot

Un certificado SSL es lo que hace que tu dominio se cargue con el candado de "conexión segura" (HTTPS). Certbot lo consigue gratis y lo renueva solo.

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d tudominio.com -d www.tudominio.com

Certbot te hará un par de preguntas (un email de contacto y aceptar los términos) y configurará Nginx automáticamente para usar HTTPS.

Esta misma página que estás leyendo es un buen ejemplo: es un simple archivo HTML (lo que llamamos "contenido estático" — no cambia según quién lo visita) que convive en el mismo servidor con aplicaciones como n8n, que sí corren dentro de un contenedor Docker. Nginx puede servir ambas cosas a la vez, cada una en su propia ruta, usando bloques location.

Servir una página estática en una subruta

Sube tus archivos (como este index.html) a una carpeta del servidor, por ejemplo /var/www/pruebayerror, y añade esto dentro del bloque server { } de tu archivo de configuración de Nginx (el mismo que creaste en el tema 3.1):

location /pruebayerror {
    alias /var/www/pruebayerror;
    index index.html;
}

alias le dice a Nginx en qué carpeta real del servidor están los archivos que debe mostrar cuando alguien visite tudominio.com/pruebayerror.

Redirigir una subruta a un contenedor Docker

Para una aplicación que corre en un contenedor (como n8n, que por defecto escucha en el puerto 5678 dentro del servidor), el bloque es distinto — en vez de apuntar a una carpeta, apunta a ese puerto:

location /n8n {
    proxy_pass http://localhost:5678;
}

Aplicar los cambios

sudo nginx -t
sudo systemctl reload nginx