← Volver al listado de tecnologías ← Índice de Nod: asistente personal de n8n labs

Instalar la app de escritorio

10 de noviembre de 2026 Por: Artiko

nodinstalacionmacoswindowswslelectron

Instalar la app de escritorio

Objetivos

Instalar Nod en macOS o en Windows 11.
Saber qué descarga y qué ejecuta la app en tu equipo.
Ubicar los datos del asistente local.
Actualizar y quitar Nod sin perder datos por accidente.

La app de escritorio no requiere Node.js, Docker ni herramientas de desarrollo. Para un asistente local necesitas tener lista una conexión de modelo: credenciales de un servicio soportado, un plan de ChatGPT que admita inicio de sesión o un servidor de modelos local como Ollama. Los proveedores de pago facturan el uso; un modelo local no tiene costo por petición.

El recorrido de la instalación

flowchart LR
    DL["Descargar<br/>el instalador"] --> Open["Abrirlo y<br/>aprobarlo"]
    Open --> Local["Get started"]
    Local --> Prep["Nod prepara<br/>su ordenador"]
    Local --> OB["Onboarding"]
    Open --> Remote["Connect to a server"]
    Remote --> Addr["Dirección<br/>y token"]
    Prep --> Chat(["Empezar a chatear"])
    OB --> Chat
    Addr --> Chat

En la pantalla Welcome hay dos caminos: Get started crea un asistente local y Connect to a server usa un asistente que ya existe en un servidor (capítulo 4).

Requisitos

	macOS	Windows
Sistema	macOS 14 o posterior, Apple silicon o Intel	Windows 11 x64 (en preview)
Para un asistente local	Nada más	WSL 2 con virtualización por hardware y al menos 20 GB libres
Descarga aproximada de la app y su runtime	1,8 GB	2,1 GB
Para conectarse a un servidor	Nada más	No hace falta WSL ni runtime local

No hay versiones de la app para Linux ni para Windows ARM. En Linux se usa la instalación desde código (capítulo 3).

Instalar en macOS

En menú Apple → Acerca de este Mac, comprueba si tu Mac tiene Chip (Apple silicon) o Procesador (Intel).

Descarga el DMG correspondiente desde GitHub:

https://github.com/n8n-io/nod/releases/latest/download/nod-arm64.dmg
https://github.com/n8n-io/nod/releases/latest/download/nod-x64.dmg

Abre el DMG, arrastra Nod a Aplicaciones y ábrelo desde ahí.
La primera vez, macOS pregunta si quieres abrir una app descargada de internet. Selecciona Open.
En Welcome, elige Get started o Connect to a server.
Mantén la conexión a internet. Cuando la preparación termina, Nod abre el chat.

Instalar desde la Terminal

Cierra Nod y pega este bloque en la Terminal:

(
  installer="$(mktemp)" || exit
  trap 'rm -f "$installer"' EXIT
  curl -q --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/n8n-io/nod/main/deployment/n8n/install.sh -o "$installer" && /bin/sh "$installer"
)

Ejecútalo con tu usuario normal, sin sudo. El script busca la última release publicada en GitHub, verifica la app descargada, la instala en /Applications/Nod.app y la abre. Una instalación existente conserva su ruta y sus datos. No hace falta cuenta de GitHub.

Instalar en Windows

Descarga el instalador:

https://github.com/n8n-io/nod/releases/latest/download/nod-Setup-x64.exe

Ejecuta nod-Setup-x64.exe. Windows muestra a n8n GmbH como editor, aunque SmartScreen puede avisar ante una release nueva. El instalador añade Nod al menú Inicio.
En Welcome, elige Get started o Connect to a server.
Si Nod necesita WSL, sigue sus instrucciones (Install WSL) y aprueba la solicitud de administrador. Si Windows pide reiniciar, vuelve a abrir Nod después: las conexiones y los ajustes guardados se conservan.
Mantén la conexión a internet hasta que Nod abra el chat.

Instalar desde PowerShell

Cierra Nod y ejecuta este comando en Windows PowerShell 5.1 o PowerShell 7:

irm https://raw.githubusercontent.com/n8n-io/nod/main/deployment/n8n/install.ps1 | iex

Usa una ventana normal de PowerShell, no Ejecutar como administrador. El script verifica el instalador y el archivo de runtime, instala Nod y lo abre.

Qué corre en tu equipo

La app es pequeña. Al configurar un asistente local descarga un runtime pack con las imágenes de contenedor, la imagen base de la máquina virtual y las herramientas que las ejecutan.

flowchart TD
    Win["Ventana de Nod"] --> Srv["Servidor de Nod (Electron)<br/>puerto loopback con token por lanzamiento"]
    Srv --> Prov["Proveedor de modelos"]
    subgraph Privado["Ordenador Linux privado"]
        PG[("PostgreSQL")]
        WS["Workspace"]
        BR["Navegador"]
    end
    Srv --> PG
    Srv --> WS
    Srv --> BR

	macOS	Windows
Ordenador privado	Máquina virtual Ubuntu con Lima y el framework Virtualization de Apple	Distribución WSL 2 privada llamada `nod-<profile>`
Recursos	La mitad de la memoria, entre 3 y 6 GiB, y un disco de 24 GiB que crece con el uso	Los de WSL 2
Docker	Corre solo dentro de la máquina virtual	Corre solo dentro de la distribución
Cambios en el sistema	Ninguno fuera de sus carpetas	No cambia la distribución WSL predeterminada ni la configuración global de WSL

En ambos sistemas, el workspace y el navegador tienen redes separadas, no acceden a tu carpeta personal, no reciben el socket de Docker ni las claves de modelos.

Sobre la descarga del runtime pack:

Cada archivo se usa solo si coincide con su SHA-256 de la release.
Durante la descarga, la pantalla muestra porcentaje y tiempo restante.
Si la descarga se corta o cierras Nod, la parte descargada se conserva y el siguiente intento pide solo lo que falta.
Si no llegan datos durante cinco minutos, la descarga se detiene y puedes reintentar.

Mantener Nod en marcha

En un asistente local, cerrar la ventana deja Nod en la barra de menús (Mac) o en la bandeja (Windows). Quit Nod detiene Nod y su ordenador privado.

Nod está	Qué corre
Abierto, o cerrado a la barra de menús o la bandeja	Chat, canales, programaciones y comprobaciones en segundo plano
Cerrado con Quit Nod, o el equipo está dormido	Nada, hasta que Nod vuelva a estar abierto y el equipo despierto

Al terminar la configuración, Nod intenta activar Open at login. Si dependes de tareas programadas, mantenlo activo en Settings → General.

Cuando la app está conectada a un servidor, es el servidor el que mantiene al asistente, los canales y las programaciones en marcha.

Actualizar Nod

Nod busca actualizaciones al arrancar, cada seis horas mientras está abierto y al despertar el equipo si toca comprobar.

Para comprobar ahora, selecciona Check for Updates… en el menú Nod (Mac) o en el icono de la barra de menús o la bandeja.
Cuando una actualización termina de descargarse, las versiones recientes muestran un aviso con Restart to update y Later. Later oculta el aviso de esa versión durante la sesión; Restart to update sigue en el menú.
Si Nod está en mitad de una tarea, pregunta antes de reiniciar. Después puedes pedirle que continúe.
Durante la instalación muestra Updating Nod… y vuelve a abrirse donde lo dejaste, con el mensaje sin enviar todavía en el cuadro.
Nod conserva tu perfil, tus claves y tus datos. Una instalación completa no repite el onboarding después de actualizar.

Actualizar un cliente conectado no actualiza su servidor.

Dónde viven tus datos

	macOS	Windows
Datos y ajustes de la app	`~/Library/Application Support/nod/profiles/local`	`%APPDATA%\nod\profiles\local`
Ordenador privado	`~/.nod-desktop/<profile id>`	Distribución WSL `nod-<profile id>`
Claves guardadas	Cifradas con el llavero de macOS	Cifradas con Windows DPAPI
Runtime packs	`~/Library/Application Support/nod/runtime/<release>`	Se importan en la distribución WSL

Para un asistente local, la base de datos, el workspace y el navegador se quedan en tu equipo. Las peticiones van al proveedor de modelos y a las apps que elijas. Las peticiones de apps gestionadas pasan por el servicio de conexión configurado y por Composio; n8n aloja el servicio por defecto.

Datos de uso. La analítica de uso está activa por defecto para un propietario nuevo. Se desactiva con Share usage data en Settings → Privacy & data. Las trazas de conversación solo salen si activas Share conversation traces en el mismo lugar.

Sin respaldo probado. La documentación indica que para la app de escritorio no hay respaldo, restauración ni vuelta a una versión anterior con soporte. La instalación completa incluye los discos de la máquina virtual, la base de datos, los archivos del workspace, los perfiles del navegador y los ajustes cifrados; copiar solo la base de datos no es un respaldo.

La app arranca con un perfil nuevo y no importa datos de una instalación desde código.

Quitar Nod

Mover Nod a la Papelera o desinstalarlo conserva los datos, de modo que una instalación posterior abre donde lo dejaste. Para borrar los datos de un asistente local:

Selecciona Remove all data en Settings → Privacy & data. Si Nod no puede terminar la configuración, usa Remove all data… en el menú Nod.
Revisa el aviso y confirma. Nod borra el perfil y el ordenador privado, reinicia y abre la configuración. La app sigue instalada.
Para quitar también la app, cierra Nod. En Mac, muévela a la Papelera. En Windows, desinstálala en Configuración → Aplicaciones.

En Mac, Nod conserva el runtime descargado y su entrada del llavero. Ninguno de los dos contiene tus datos. Las apps que conectaste pueden seguir listando a Nod hasta que lo quites allí.

Problemas frecuentes

Problema	Qué hacer
macOS bloquea el primer arranque	Instala la release más reciente. En un Mac administrado, pide a tu equipo de TI que permita Nod
La configuración se detiene con un error	Selecciona Try again. Si vuelve a fallar, envía el error con Send feedback… desde el icono de la barra de menús o la bandeja
Nod pide un archivo de runtime	Selecciona Choose runtime file y elige el archivo `nod-Runtime-…` de la misma release
Windows no puede descargar el runtime	Coloca `nod-Runtime-win32-x64.tar.gz` de la misma release junto a `nod-Setup-x64.exe` y ejecuta el instalador de nuevo
Windows descarga la misma actualización tras reiniciar	Nod 0.6.2 y anteriores no pueden instalar actualizaciones en Windows. Cierra Nod desde la bandeja y ejecuta una vez el instalador más reciente
Una tarea programada no se ejecutó	Comprueba que el equipo estaba despierto y Nod en marcha

Una actualización fallida en Mac bloquea una instalación nueva

Tras una actualización fallida, el trabajo de actualización ShipIt puede quedar cargado. Si macOS dice que “Nod” está dañado y no se puede abrir, quita ese trabajo antes de instalar de nuevo:

Cierra Nod. Si sigue abierto, detenlo con el Monitor de Actividad.
Ejecuta estos comandos con tu usuario normal:
```
launchctl bootout "gui/$(id -u)/dev.nod.desktop.ShipIt"
rm -rf "$HOME/Library/Caches/dev.nod.desktop.ShipIt"
```
Si no hay ningún trabajo ShipIt cargado, el primer comando puede informar un error. Continúa con el segundo.
Descarga el DMG más reciente, reemplaza la copia en Aplicaciones y ábrela.

Estos comandos quitan solo el trabajo de actualización y su caché. Conservan el perfil, las conversaciones, las claves guardadas y el ordenador privado.

No borres el perfil ni el ordenador privado para arreglar un problema. Se perderían las conversaciones, el workspace y las claves guardadas.

Actividad

Instala Nod en tu sistema con el instalador o con el comando de terminal.
Elige Get started y deja que termine de preparar su ordenador.
Ubica en tu disco la carpeta del perfil y la del ordenador privado.
Abre Settings → General y comprueba el estado de Open at login.
Abre Settings → Privacy & data y decide el valor de Share usage data.

Autoevaluación

1. ¿Qué necesita Windows para un asistente local que no necesita para conectarse a un servidor?

WSL 2 con virtualización por hardware y al menos 20 GB libres, además del runtime local.

2. ¿Qué diferencia hay entre cerrar la ventana y usar Quit Nod?

Cerrar la ventana deja Nod en la barra de menús o la bandeja, con programaciones y canales en marcha. Quit Nod detiene Nod y su ordenador privado.

3. ¿Desinstalar la app borra los datos?

No. Para borrarlos hay que usar Remove all data en Settings → Privacy & data.

4. ¿Dónde corre Docker en la app de escritorio?

Solo dentro del ordenador privado: la máquina virtual en Mac o la distribución WSL en Windows.

5. ¿Con qué permisos se ejecutan los instaladores de terminal?

Con el usuario normal: sin sudo en Mac y sin ejecutar PowerShell como administrador en Windows.

Lista de control

Nod está instalado y abre el chat.
Sé dónde está la carpeta del perfil y la del ordenador privado.
Revisé Open at login y Share usage data.
Sé comprobar actualizaciones con Check for Updates….
Sé que desinstalar conserva los datos y que Remove all data los borra.

Anterior: Qué es Nod · Siguiente: Instalar desde código fuente