Download Obscura

One app: a non-custodial wallet, the cross-chain swap desk, and one-click mining — running on your own node, so your keys and your activity never leave your machine. Single static binary, no dependencies.

The app runs your own node, so (unlike the hosted web wallet) your IP and balance scans stay private to you.

macOS

Apple Silicon & Intel · macOS 10.13+
Download (Apple Silicon) Intel Mac (amd64)

See “cannot be opened”? That's expected — the build isn't Apple-signed. How to open it →

Windows

Windows 10/11 · 64-bit
Download (x64) ARM64

Linux

glibc x86-64 & ARM64
Download (x86-64) ARM64

Verify your download against SHA256SUMS.txt before running it (commands below). Mirror: the same files are published as the GitHub release v1.0.0.

Run it

  1. Unzip the download.
  2. macOS: open Obscura-darwin-arm64.app (first launch needs the unsigned-build step). Windows: double-click Obscura.bat. Linux: run ./obscura.
  3. A native app window opens with your wallet, swap, and mining. The node bootstraps to the network automatically (built-in seeds + peer exchange) and starts mining immediately to the app's built-in miner wallet — you can redirect rewards to your own wallet from the Mine tab.
  4. Back up your recovery phrase immediately — it is stored only on this machine; if you lose it, your coins are gone for good.

⚠ First-launch security warning (unsigned builds)

These builds are not code-signed, so the OS will warn you the first time. Verify the checksum, then:

macOS — “cannot be opened because Apple cannot check it for malicious software”

This appears because the build isn't signed with an Apple Developer ID — not because it's unsafe. The download is a .zip; double-click it to unzip and you get Obscura-darwin-arm64.app (or Obscura-darwin-amd64.app on Intel). Open it with either method below (first run only):

Terminal — clear the quarantine flag, then open:

xattr -dr com.apple.quarantine ~/Downloads/Obscura-darwin-arm64.app
open ~/Downloads/Obscura-darwin-arm64.app

Finder (no Terminal) — in Finder, Control-click (right-click) Obscura-darwin-arm64.app → Open → click Open in the dialog. If you don't get an Open button, go to System Settings → Privacy & Security, scroll to the “Obscura-darwin-arm64 was blocked” notice, and click Open Anyway.

Windows — “Windows protected your PC” (SmartScreen)

Click More info → Run anyway. If a zone block remains, unblock the file first:

Right-click Obscura.bat → Properties → check "Unblock" → OK
🧅 Tor privacy is ON by default — the node auto-starts Tor and routes all P2P over its own hidden service, so your real IP is hidden from peers with no setup (the installer installs tor for you). Running a public/seed node, dev box, or CI? Opt out with --clearnet. If tor is missing the node fails closed (it won't silently expose your IP) — install tor or pass --clearnet.
ℹ️ Mining (--mine) auto-sells some of your mined OBX for XNO by default so the DEX has real liquidity out of the box — this publishes a miner→XNO link on the public Nano ledger, which can be linked back to your mining. Opt out any time with --no-auto-liquidity (or OBX_AUTO_LIQUIDITY=0).
Linux / macOS — one command (install, and re-run to upgrade)

Installs + starts a full node + miner that joins mainnet — with Tor IP privacy on by default (it installs tor and runs your node behind an auto hidden service). Run the exact same command again any time to upgrade: it detects the running node, checks for a newer published build, asks you to confirm, replaces the binary, and restarts it. Your wallet/miner keys in ~/.obscura are never touched — only the program is replaced.

# install + run, and re-run to upgrade (verifies the SHA-256 before replacing)
curl -fsSL https://obscura-protocol.space/install.sh | sh

Pass your own node flags after -s -- (defaults to --mine --seeds 139.59.183.15:18080,188.166.153.86:18080):

curl -fsSL https://obscura-protocol.space/install.sh | sh -s -- --mine --seeds 139.59.183.15:18080,188.166.153.86:18080

Running a public / seed node (a VPS reachable by IP)? Add --clearnet to opt out of Tor and run as a public clearnet node (your IP is visible to peers). Re-run the same line any time to upgrade:

curl -fsSL https://obscura-protocol.space/install.sh | sh -s -- --clearnet --mine --seeds 139.59.183.15:18080,188.166.153.86:18080

On a desktop with a screen, use the GUI app instead: tar xzf Obscura-linux-amd64.tar.gz && cd Obscura-linux-amd64 && ./obscura (wallet + swap + mining window).

Prefer to do it by hand? Install tor first (e.g. sudo apt-get install -y tor / brew install tor) so the default IP privacy works, then: curl -fL https://obscura-protocol.space/releases/Obscura-linux-amd64.tar.gz | tar xz && ./Obscura-linux-amd64/obscura-node --mine --seeds 139.59.183.15:18080,188.166.153.86:18080 (Tor auto-starts; add --clearnet for a public/seed node).

Windows — one command (install, and re-run to upgrade)

In PowerShell. Re-run the same line to upgrade — keys in %USERPROFILE%\.obscura are preserved, only the binary is replaced:

iwr -useb https://obscura-protocol.space/install.ps1 | iex

Verify the checksum

# macOS / Linux — compare against SHA256SUMS.txt
shasum -a 256 Obscura-darwin-arm64.zip
# Windows (PowerShell)
Get-FileHash .\Obscura-windows-amd64.zip -Algorithm SHA256

The printed hash must match the line for your file in SHA256SUMS.txt. If it doesn't, do not run the file.

The same checksums are published on GitHub for independent verification: github.com/obscura-node/obscura · RELEASES.md (source: github.com/obscura-node/obscura).

Prefer to build from source?

git clone https://github.com/obscura-node/obscura && cd obscura
CGO_ENABLED=0 go build -o obscura-node ./cmd/obscura-node
./obscura-node --ui --mine        # wallet + swap + mining desktop app (Tor privacy on by default)

Pure Go, CGO-free — cross-compiles to every OS. The node auto-starts Tor and hides your IP by default (install tor on PATH); pass --clearnet to run without it. See the quickstart.