Qué necesitás para un n8n self-hosted
Para instalar n8n en un servidor y dejarlo estable hacen falta cinco cosas: el contenedor de n8n, Postgres en vez del archivo SQLite por defecto, un volumen persistente para la carpeta de usuario de n8n, una clave de cifrado que fijás una vez y conservás, y una URL pública para los webhooks.
n8n escucha en el puerto 5678. La instalación con Docker de n8n corre la imagen n8nio/n8n y publica ese puerto. La plantilla de esta nota corre en Cloud Apps. Un servidor Linux en la nube es la otra forma, cuando quieres operar el host. Si ese host corre un PaaS autoalojado, lo que queda de tu lado está en PaaS autoalojado. La plantilla de n8n en Unbroker corre n8nio/n8n:2.44.1 en el mismo puerto, con un Postgres 16 privado, un volumen de 1 GiB para los datos de n8n y un volumen de 1 GiB para Postgres. Esta nota es la configuración que mantiene ese esquema. Cómo conectar una app a Postgres, y cómo restaurarlo, está en Postgres en producción. Un stack de varios servicios, como Supabase, es otro inventario: Hostear Supabase.
Por qué Postgres y no SQLite
Por defecto, n8n usa SQLite para guardar credenciales, ejecuciones anteriores y workflows. El archivo es ~/.n8n/database.sqlite cuando no configuraste una base. n8n también soporta PostgreSQL. Lo elegís con DB_TYPE=postgresdb, y después definís DB_POSTGRESDB_HOST, DB_POSTGRESDB_PORT, DB_POSTGRESDB_DATABASE, DB_POSTGRESDB_USER y DB_POSTGRESDB_PASSWORD. El nombre de la base arranca en n8n. El usuario arranca en postgres. El host arranca en localhost y el puerto en 5432.
La página de bases de n8n lista PostgreSQL 16 como la versión mayor extra de compatibilidad, al lado de 17 y 18, en una nota de julio de 2026. La misma página dice que ese rango se mueve cada noviembre, así que volvé a leerla antes de elegir otra mayor. El queue mode con SQLite no está recomendado, y una cola distribuida sobre SQLite no está soportada. La plantilla no activa el queue mode. Pone DB_TYPE=postgresdb y apunta las variables de Postgres a un servicio Postgres 16 privado. Workflows, ejecuciones y usuarios viven en esa base.
Esa base es un nodo de Apps que operás vos: una imagen, un volumen y la recuperación de ese volumen. No es un clúster de Postgres gestionado. El Postgres gestionado en Unbroker requiere Pro. El plan más chico del catálogo es 1 vCPU, 1 GB de RAM y 10 GB de almacenamiento a $21.21 por mes, aparte de la cuota Pro.
La clave de cifrado
n8n cifra las credenciales antes de guardarlas. Si no definís una clave, n8n genera una al azar en el primer arranque y la guarda en la carpeta de usuario. N8N_ENCRYPTION_KEY es la forma de poner esa clave vos, antes de que quede escrita en el archivo de configuración. Sin la clave, una base restaurada o una exportación cifrada de credenciales no se puede descifrar.
La plantilla genera N8N_ENCRYPTION_KEY. No la cambies ni la borres. Si la perdés, las credenciales guardadas quedan ilegibles. Las notas de rotación de n8n dicen que esta clave de instancia no cambia: protege las claves de datos. Hacé un backup completo de la base antes de activar esa rotación.
N8N_USER_FOLDER es la ruta donde n8n crea la carpeta .n8n. La plantilla la pone en /data y monta ahí un volumen de 1 GiB, para archivos de credenciales y nodos de la comunidad. Con Postgres, la base queda fuera de esa carpeta. La carpeta igual guarda la configuración de n8n, así que entra en el backup.
URL de webhooks y dominio propio
n8n arma la URL de un webhook con su protocolo, su host y su puerto. Detrás de un proxy inverso, esa combinación es la dirección interna, no la pública. Definí la URL base de webhooks para que el editor muestre la URL que registraste en otros servicios.
La documentación de n8n nombra N8N_WEBHOOK_URL para esa URL base, tanto en webhooks de prueba como de producción. WEBHOOK_URL quedó en desuso desde n8n 2.35.0. Sigue funcionando, y n8n escribe un aviso al arrancar. La imagen de la plantilla es n8nio/n8n:2.44.1, y la plantilla pone WEBHOOK_URL en la URL pública del servicio.
N8N_EDITOR_BASE_URL es la URL pública del editor. n8n también la usa en los mails y como redirect de SAML. La plantilla la deja en la misma URL pública, y pone N8N_PROXY_HOPS en 1, que es la cantidad de saltos que pide la documentación del proxy inverso. Esa documentación también lista X-Forwarded-For, X-Forwarded-Host y X-Forwarded-Proto en el último proxy cuando ese proxy lo corrés vos.
Si sumás un dominio propio, actualizá WEBHOOK_URL y N8N_EDITOR_BASE_URL para que las dos apunten a ese dominio. La plantilla no las reescribe sola.
Creá la cuenta owner enseguida
La primera vez que abrís n8n, la app muestra una pantalla de registro. La cuenta que creás ahí es el owner de la instancia. La contraseña tiene que tener al menos ocho caracteres, con un número y una mayúscula. La plantilla avisa que la primera persona que abre la URL se queda con ese registro. Abrila vos apenas el servicio esté arriba.
n8n recomienda un servidor SMTP para invitaciones y para recuperar la contraseña, y dice que el SMTP es opcional desde n8n 0.210.1. Si lo salteás, los usuarios no pueden resetear la contraseña. La plantilla no configura SMTP.
Que las ejecuciones no llenen la base
Las ejecuciones terminadas, y los datos que se guardan con ellas, son lo que hace crecer la base. n8n borra ese historial de forma continua, y la poda viene activada.
EXECUTIONS_DATA_PRUNE arranca en true. Una ejecución terminada entra cuando supera EXECUTIONS_DATA_MAX_AGE horas, o cuando la cantidad guardada pasa EXECUTIONS_DATA_PRUNE_MAX_COUNT. La edad por defecto es 336 horas, o sea 14 días. La cantidad por defecto es 10.000. Poné la cantidad en 0 si no querés límite por cantidad. Cuando poda por cantidad, n8n borra de la más vieja a la más nueva. Las ejecuciones en new, running o waiting no entran. Las ejecuciones anotadas, por ejemplo con tags o una valoración, no se podan nunca.
La plantilla no define estas variables, así que aplican esos defaults. Cambiá EXECUTIONS_DATA_MAX_AGE si 14 días no es la ventana que necesitás. En el SQLite por defecto, las filas podadas no devuelven disco hasta un vacuum. La plantilla usa Postgres, así que ese límite de SQLite no le aplica.
Zona horaria, schedules y memoria
El Schedule Trigger usa la zona horaria del workflow si ese workflow tiene una. Si no, usa la de la instancia. La zona horaria por defecto de n8n es America/New_York. GENERIC_TIMEZONE la cambia. El nodo Schedule lee ese valor para saber cuándo arranca un workflow.
La plantilla tiene un input TIMEZONE. El default es UTC. Escribe ese valor en GENERIC_TIMEZONE y en TZ. Un schedule en esta plantilla corre en UTC, salvo que definas TIMEZONE al desplegar o que pongas una zona horaria en el workflow.
La plantilla aclara que los triggers de schedule y los de polling corren adentro del proceso de n8n, así que el servicio tiene que seguir en marcha si dependés de ellos. La plantilla es un servicio de imagen con volumen persistente, y los dos quedan en una sola réplica. Subí la memoria en la pestaña Scale del servicio cuando un workflow pide más. No sumás una segunda réplica. Los servicios de imagen y los que tienen volumen persistente quedan siempre encendidos. El sleep de On-demand no está disponible para ellos.
Backups y actualizaciones
La nota de backup de n8n pide dos copias: la carpeta de usuario, y la base externa si usás PostgreSQL. Las credenciales de la base están cifradas. Un restore que no incluye la clave de cifrado no las puede descifrar. n8n recomienda un backup completo antes de actualizar. Cargá ese backup una vez antes de llamarlo un plan. Un archivo que nunca restauraste no es un restore.
En Unbroker, los datos de n8n son el volumen de 1 GiB montado en /data. Postgres tiene su propio volumen de 1 GiB. Un volumen sobrevive a un redeploy, a un reinicio y a un rollback del código. Reset, detach y borrar el servicio eliminan los datos del volumen. Los backups de volumen van a un bucket compatible con S3 que controlás, en un horario que definís, y piden Pro. Las imágenes reconocidas como Postgres, incluida pgvector/pgvector, reciben backups con pg_dump. El preset de Postgres de Apps corre pgvector/pgvector:pg16. El camino del volumen está en almacenamiento persistente.
La plantilla fija n8nio/n8n:2.44.1. Salí de ese tag recién cuando un restore del volumen y de la base haya funcionado.
Correrlo en Unbroker
La plantilla de n8n despliega el contenedor, el Postgres privado, los volúmenes, la clave de cifrado generada y la URL pública de webhooks de arriba. Igual operás esa copia. No es el producto alojado de n8n.
Los contenedores, las bases y los volúmenes persistentes requieren Pro. Pro sale $25 por mes con $25 de crédito de uso. El crédito se reinicia en cada ciclo y no pasa al siguiente. El uso que supera el crédito se factura aparte. Free no incluye volúmenes persistentes ni imágenes de contenedor, así que esta plantilla no es un deploy de Free. Precios es la página del plan. El resto del catálogo está en plantillas.
Preguntas frecuentes
¿Qué necesito para un n8n self-hosted?
El contenedor de n8n, Postgres en vez del archivo SQLite por defecto, un volumen persistente para la carpeta de usuario de n8n, una clave de cifrado que fijás una vez y conservás, y una URL pública para los webhooks. La plantilla de n8n arma ese esquema en Unbroker.
¿Por qué Postgres y no SQLite en n8n?
SQLite es el default. n8n guarda credenciales, ejecuciones anteriores y workflows en ~/.n8n/database.sqlite si no configurás una base. PostgreSQL es la base de servidor que n8n soporta. Poné DB_TYPE en postgresdb y las variables DB_POSTGRESDB_HOST, DB_POSTGRESDB_PORT, DB_POSTGRESDB_DATABASE, DB_POSTGRESDB_USER y DB_POSTGRESDB_PASSWORD. n8n no recomienda el queue mode con SQLite, y una cola distribuida sobre SQLite no está soportada.
¿Qué pasa si pierdo la clave de cifrado de n8n?
Las credenciales guardadas quedan ilegibles. n8n cifra las credenciales antes de guardarlas. N8N_ENCRYPTION_KEY es la clave de la instancia. Si no la definís, n8n genera una al azar en el primer arranque. Una base restaurada no se puede descifrar sin esa misma clave. La plantilla de Unbroker la genera. No la cambies ni la borres.
¿Qué variable define la URL de webhooks de n8n?
La documentación actual de n8n nombra N8N_WEBHOOK_URL. Define la URL base de los webhooks de prueba y de producción detrás de un proxy inverso. WEBHOOK_URL quedó en desuso desde n8n 2.35.0. Sigue funcionando, y n8n escribe un aviso al arrancar. La plantilla de Unbroker pone WEBHOOK_URL y N8N_EDITOR_BASE_URL en la URL pública del servicio. Actualizá las dos si sumás un dominio propio.
¿Quién queda como owner de un n8n self-hosted?
La cuenta que se crea en la pantalla de registro la primera vez que abrís n8n. Esa cuenta es el owner de la instancia. La contraseña tiene que tener al menos ocho caracteres, un número y una mayúscula. En la plantilla de Unbroker, la primera persona que abre la URL se queda con ese registro, así que abrila vos apenas el servicio esté arriba.
¿Cómo evito que las ejecuciones de n8n llenen la base?
n8n poda las ejecuciones terminadas por defecto. EXECUTIONS_DATA_PRUNE arranca en true. EXECUTIONS_DATA_MAX_AGE arranca en 336 horas (14 días). EXECUTIONS_DATA_PRUNE_MAX_COUNT arranca en 10000, y 0 significa sin límite por cantidad. Las ejecuciones new, running o waiting no se podan. Las ejecuciones anotadas no se podan nunca. La plantilla de Unbroker no define estas variables, así que aplican los defaults.
¿Qué plan pide un n8n self-hosted en Unbroker?
Pro. Los contenedores de una plantilla, las bases y los volúmenes persistentes requieren Pro. Pro sale $25 por mes con $25 de crédito de uso, y el uso se factura aparte. Free no incluye volúmenes persistentes ni imágenes de contenedor. El Postgres de la plantilla es un servicio de Apps que operás vos, no un Postgres gestionado. Mirá precios y Postgres gestionado.