How to Install Nod on Mac

You can install Nod on a Mac in about 10 minutes. Download the app, open it, choose Get started on the Welcome screen, and let Nod download its runtime — no Node.js, Docker, or developer tools are needed for the desktop app. This guide covers the requirements, both install methods (the app download and an official one-line Terminal script), what to do on first launch, and the handful of snags new users actually run into.

New to Nod itself? Start with What is Nod for the two-minute version of what it does. If you're on a Windows machine instead, use the Windows install guide.

What you need before you start

Nod is free and open source (Apache 2.0). The only ongoing cost is whatever your model provider charges you — the pricing page breaks that down.

Method 1: Download and install the app

This is the path the official docs recommend for most people.

  1. Go to the Nod site (nod.n8n.io) or the releases page of the n8n-io/nod GitHub repository, and download the DMG for your chip. There are two separate builds — one for Apple silicon, one for Intel — so grab the one that matches your Mac.
  2. Open the DMG and move Nod into your Applications folder.
  3. Launch Nod. The Welcome screen offers two choices: Get started sets up the local assistant on this Mac, while Connect to a server attaches the app to a Nod server you already run elsewhere. Choose Get started.
  4. Wait for the runtime download to finish. This is the bulk of the roughly 1.8 GB, so on a slow connection it is most of the setup time.
  5. When setup completes, connect a model — then you're ready for your first task.

According to the official docs, the whole setup takes about 10 minutes. What the runtime actually gives you is worth knowing: Nod works inside its own private, sandboxed computer on your Mac, with its own separate browser. That's what lets it operate files, run commands, and fill in forms on real websites — including sites that have no integration with anything — while your own desktop and browser stay yours.

Method 2: Install from the Terminal

If you prefer the command line, the official install docs provide an install.sh script that does the same job in one line. Per the docs, the script finds the latest release automatically, verifies the download, and installs the app to /Applications/Nod.app. It runs as your normal user — no sudo, and no GitHub account required.

  1. Open Terminal.
  2. Copy the one-line install command from the official install docs (nod.n8n.io/docs, "Install the desktop app") and run it.
  3. Launch Nod from Applications and follow the same Welcome screen steps as above: Get started, wait for the runtime, connect a model.

First launch: three things to do

Once the app is running, three quick setup jobs turn it from "installed" to "useful":

  1. Connect a model. Open Settings → Models, add a connection, and pick your model. The fastest route for most people is signing in with an existing ChatGPT Plus or Pro plan; API keys work too. Full walkthrough: Connect a model.
  2. Connect your apps. Email and calendar are the two that unlock Nod's flagship jobs — morning call briefs and invoice chasing. See Connect apps.
  3. Set a spending limit, and check the privacy toggle. You can cap monthly model spend so there are no surprise bills. Also note: new installs share basic usage data with n8n by default. If you'd rather not, turn off Share usage data in Settings → Privacy & data (per the official docs). Conversation traces are only sent if you separately switch them on.

Common problems and fixes

You downloaded the wrong DMG. There are separate Apple silicon and Intel builds. Check your chip under Apple menu → About This Mac, then download the matching installer.

Your macOS is too old. Nod requires macOS 14 or later, on both chip families — there's no build for older systems. If you're below 14, a system update is the only route; check Software Update before troubleshooting the installer itself.

The first-run download seems stuck. The app-plus-runtime download is about 1.8 GB. On a slow or flaky connection it can look stalled; let it finish on a stable network before assuming the install is broken.

An update appears to cancel itself. Per the official install docs, on Nod 0.8.4 and earlier, opening the old version while an update is installing cancels the update. The fix is to download the latest installer manually once and install it over the top. After that you're on the normal track: Nod checks for updates at launch and every 6 hours, and downloads them in the background.

Nod "stopped working" overnight. It didn't crash — it sleeps when your Mac sleeps. On a laptop, Nod only runs while the computer is awake and the app is open; chats, channels, and scheduled jobs all pause otherwise. If you want it working around the clock, n8n's own suggestion is to run it on an always-on machine such as a Mac mini, or on your own server.

Next steps