Primeros pasos con N8N: Instalación y Configuración Básica

¿Qué es N8N?

N8N es una herramienta de automatización de flujo de trabajo “fair-code” que te permite conectar cualquier aplicación con otra. A diferencia de Zapier o Make, N8N es auto-alojable, lo que significa que puedes ejecutarlo en tu propio servidor sin límites de ejecuciones artificiales (más allá de lo que soporte tu hardware).

Requisitos Previos

Un servidor VPS (Ubuntu 22.04 recomendado).
Docker y Docker Compose instalados.
Un dominio apuntando a tu servidor.

Paso 1: Preparando el entorno

Lo primero es crear una carpeta para nuestro proyecto.

mkdir n8n-setup
cd n8n-setup

Paso 2: El archivo Docker Compose

Crea un archivo docker-compose.yml con el siguiente contenido. Este stack incluye PostgreSQL como base de datos para mayor robustez:

version: '3.8'

volumes:
  db_storage:
  n8n_storage:

services:
  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=tu_password_seguro
      - POSTGRES_DB=n8n
    volumes:
      - db_storage:/var/lib/postgresql/data
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -h localhost -U n8n -d n8n']
      interval: 5s
      timeout: 5s
      retries: 10

  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=tu_password_seguro
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=admin_password
    links:
      - postgres
    volumes:
      - n8n_storage:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy

Paso 3: Arrancando el servicio

Ejecuta el siguiente comando para descargar las imágenes e iniciar los contenedores:

docker compose up -d

Conclusión

Ahora puedes acceder a tu instancia de N8N en http://tu-ip:5678. ¡Felicidades! Has dado el primer paso hacia la automatización total.

En el próximo tutorial, veremos cómo asegurar esta instalación con SSL y conectarla a un dominio real.