Install

Pick the desktop installer for your OS, or the headless CLI for servers.

Download

All builds are published on GitHub:

github.com/space-labs/space-router-node/releases/latest

Platform	GUI installer	Headless CLI
Windows x64	spacerouter-gui-windows-x64-setup.exe	space-router-node-windows-x64.exe
macOS (Apple Silicon)	spacerouter-gui-macos-arm64.dmg	space-router-node-macos-arm64
Linux x64	—	space-router-node-linux-x64
Linux x64 (Debian/Ubuntu)	—	space-router-node-linux-x64.deb
Linux x64 (RHEL/Fedora)	—	space-router-node-linux-x64.rpm

Desktop install

macOS

1. Open the downloaded .dmg file.

2. Drag SpaceRouter Proxy into your Applications folder.

3. Launch SpaceRouter Proxy from Launchpad or Spotlight.

Windows

1. Run the downloaded spacerouter-gui-windows-x64-setup.exe.

2. Follow the installer prompts. Windows SmartScreen may warn about an unrecognized publisher — click More info → Run anyway.

3. Launch SpaceRouter Proxy from the Start menu.

Linux

The AppImage is portable — no install step needed:

chmod +x spacerouter-gui-linux-x64.AppImage
./spacerouter-gui-linux-x64.AppImage

Headless / server install

macOS / Linux (binary)

# macOS Apple Silicon
chmod +x space-router-node-macos-arm64
./space-router-node-macos-arm64

# Linux x64
chmod +x space-router-node-linux-x64
./space-router-node-linux-x64

Linux .deb (Debian, Ubuntu)

sudo dpkg -i space-router-node-linux-x64.deb
sudo systemctl enable --now spacerouter-node

Linux .rpm (RHEL, Fedora)

sudo rpm -i space-router-node-linux-x64.rpm
sudo systemctl enable --now spacerouter-node

Windows (binary)

.\space-router-node-windows-x64.exe

What gets installed where

v1.5 unifies the data directory across all operating systems:

Platform	Data directory
macOS (GUI & CLI)	~/.spacerouter/
Linux (GUI & CLI)	~/.spacerouter/
Windows (GUI & CLI)	%USERPROFILE%\.spacerouter\
Linux (.deb / .rpm system service)	/opt/spacerouter/

What's in the data directory

~/.spacerouter/
├── certs/
│   ├── node-identity.key      # your private key — back this up
│   ├── node.crt               # TLS cert (auto-renewed)
│   └── node.key
├── settings.json              # canonical config
├── receipts.db                # local SQLite store of receipts
├── incidents.json             # auto-claim failure log
└── logs/                      # runtime logs

Back up your identity key

node-identity.key is the cryptographic identity of your node. Lose it and you lose your earnings history (though not your stake). Copy it to safe storage right after first run.

Upgrading

To upgrade to a new release:

• GUI: Quit the app, install the new build over the old one, relaunch. Your ~/.spacerouter/ is preserved.

• CLI binary: Stop the running process, replace the binary, restart.

• Linux .deb / .rpm: sudo dpkg -i / sudo rpm -U the new package.

Migrating from v1.4

On first launch of v1.5, the app automatically migrates your old config and identity key from the v1.4 location to ~/.spacerouter/. The migration is one-way and idempotent. Your stake, earnings history, and identity are preserved.

Once installed, head to First-Time Setup.