> For the complete documentation index, see [llms.txt](https://docs.spacecoin.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spacecoin.org/spacerouter-proxy/proxy-provider-guide/install.md).

# Install

### Download

All builds are published on GitHub:

[**github.com/space-labs/space-router-node/releases/latest**](https://github.com/space-labs/space-router-node/releases/latest)

<table><thead><tr><th width="154.16796875">Platform</th><th>GUI installer</th><th>Headless CLI</th></tr></thead><tbody><tr><td>Windows x64</td><td><code>spacerouter-gui-windows-x64-setup.exe</code></td><td><code>space-router-node-windows-x64.exe</code></td></tr><tr><td>macOS (Apple Silicon)</td><td><code>spacerouter-gui-macos-arm64.dmg</code></td><td><code>space-router-node-macos-arm64</code></td></tr><tr><td>Linux x64</td><td>—</td><td><code>space-router-node-linux-x64</code></td></tr><tr><td>Linux x64 (Debian/Ubuntu)</td><td>—</td><td><code>space-router-node-linux-x64.deb</code></td></tr><tr><td>Linux x64 (RHEL/Fedora)</td><td>—</td><td><code>space-router-node-linux-x64.rpm</code></td></tr></tbody></table>

### 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)

```bash
# 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
```

{% hint style="warning" %}
**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.
{% endhint %}

### 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.