Ghostdrive

News · Learn · November 16, 2026

Run a Ghostdrive node in five steps

A node keeps your encrypted files reachable when your devices are off. Five commands, about a minute, on a Mac, a Linux box or a server.

DRIVE 369 DAO · 3 min read

A node is a small program that stays on, on a computer you own. It keeps your encrypted files reachable when your phone and laptop are off, and it helps other people's devices find each other. It holds ciphertext only: it cannot read what it stores.

We ran the steps below on 16 November 2026 as a new person would, from the public repository on a clean Linux machine with Node.js 22. Download, build and link took 39 seconds, and the node found other nodes by itself.

The easy way

Install the desktop app. It runs a node beside the app, with nothing to set up. If that is enough for you, stop here.

What you need for the manual way

  • A computer that stays on: a Mac, a Linux box, a small server.
  • git and Node.js 22.12 or newer. Check with node -v.
  • A terminal. On a Mac it is the Terminal app.

Step 1. Get the code

git clone https://github.com/NeyraLabs/ghostdrive

This downloads the open-source core into a folder named ghostdrive.

Step 2. Build it

cd ghostdrive/packages
npm install && npm run build

The first command enters the folder. The second downloads what the code needs and builds it. It takes about a minute.

Step 3. Add the ghostdrive command

npm link -w @ghostdrive/node

Now you can type ghostdrive from any folder.

Step 4. Create your node

ghostdrive init

Run it once. It makes the node's folder and its own key on this computer, and prints the ports it will use.

Step 5. Start it

ghostdrive daemon

Leave this window open. Lines that begin with + peer mean the node has joined the network. That is all: you run a node.

Connect the app to your node

In a second terminal window:

ghostdrive api allow https://www.ghostdrive.com
ghostdrive api token

The first line lets the site talk to your node. The second prints a token. In the app, open Settings → AI → Your node, enter the address http://127.0.0.1:5369 and paste the token. The same steps are in Settings, with a copy button on each command.

Two common variations

You wantUse instead of step 4
A backup node that holds your vault and a copy of every fileghostdrive init --restore, paste your 24 recovery words, then ghostdrive backup on
A node on a server you do not fully controlghostdrive init --storage-only: it holds sealed blocks and never your vault

Put your 24 words only on a computer you trust. Anyone who has them can read your vault.

What to know before you rely on it

  • On a server with no keychain, the node's key is kept in a plain file and the node says so when it starts. Set GHOSTDRIVE_NODE_KEK to seal it.
  • We tested these steps on macOS and Linux. Windows is not tested yet.
  • Running a node pays nothing today. Storage deals run on a testnet only, and its units have no value.
  • The node stops when you close the window. To keep it running after a restart, run it as a service; the Docs list the options.

Tell us what broke

Write to hello@ghostdrive.com with your machine, your operating system and the line where it stopped, or open an issue on GitHub. The earlier guide on which machine to pick is still current.

Questions

What is a Ghostdrive node?
A small program that stays on, on a computer you own. It stores encrypted blocks, serves your devices and helps others connect. It holds ciphertext only.
What do I need to run a node?
A computer that stays on, git and Node.js 22.12 or newer. The desktop app runs a node with nothing to set up.
How do I know the node works?
The window where it runs prints lines that begin with "+ peer". Each one is another node it has connected to.
Does a node earn money?
No. Storage deals run on a testnet only and its units have no value.