Installation

Quick install (macOS / Linux)

The fastest way to install SeedNet:

curl -fsSL https://seednet.oboard.fun/install.sh | sudo sh

This script automatically detects your OS and architecture, downloads the appropriate binary, and installs it to /usr/local/bin/seednet.

Install options

Install a specific version:

curl -fsSL https://seednet.oboard.fun/install.sh | sudo SEEDNET_VERSION=0.1.1 sh

Install to a custom directory:

curl -fsSL https://seednet.oboard.fun/install.sh | sudo SEEDNET_INSTALL_DIR=/opt/seednet sh

Download a pre-built binary

The easiest way to get SeedNet. No build tools required.

1. Visit the GitHub Releases page
2. Download the binary for your OS and architecture
3. Make it executable and place it in your PATH

macOS / Linux

# macOS Apple Silicon
curl -LO https://github.com/oboard/seednet/releases/latest/download/seednet-aarch64-apple-darwin

# macOS Intel
curl -LO https://github.com/oboard/seednet/releases/latest/download/seednet-x86_64-apple-darwin

# Linux x86_64 (glibc)
curl -LO https://github.com/oboard/seednet/releases/latest/download/seednet-x86_64-unknown-linux-gnu

# Linux x86_64 (musl)
curl -LO https://github.com/oboard/seednet/releases/latest/download/seednet-x86_64-unknown-linux-musl

# Linux ARM64
curl -LO https://github.com/oboard/seednet/releases/latest/download/seednet-aarch64-unknown-linux-gnu

chmod +x seednet-*
mv seednet-* /usr/local/bin/seednet

macOS: If Gatekeeper blocks the binary, open System Settings → Privacy & Security and click Allow Anyway.

Windows

Download seednet-x86_64-pc-windows-msvc.exe or seednet-aarch64-pc-windows-msvc.exe, rename it to seednet.exe, and place it in a folder that is in your %PATH% (e.g. C:\Windows\System32 or a custom tools folder).

Arch Linux (AUR)

SeedNet is available in the AUR. Install with your favorite AUR helper:

# Using yay
yay -S seednet

# Using paru
paru -S seednet

# Using makepkg
git clone https://aur.archlinux.org/seednet.git
cd seednet
makepkg -si

Note: The AUR package builds from source. For pre-built binaries, use the quick install method above.

Nix / NixOS

SeedNet is available in nixpkgs:

# Ad-hoc usage
nix run nixpkgs#seednet

# Install to profile
nix profile install nixpkgs#seednet

# In NixOS configuration
# Add to /etc/nixos/configuration.nix:
# environment.systemPackages = [ pkgs.seednet ];

Note: If SeedNet is not yet in nixpkgs, you can use the local derivation from packaging/nix/.

Verify the installation

seednet --version

You should see the version string printed.

Build from source

You need Rust (stable toolchain).

git clone https://github.com/oboard/seednet.git
cd seednet
cargo build --release
# Binary is at: target/release/seednet

State directory

SeedNet stores its state (identity, peers, logs, PID) in ~/.seednet/ by default. You can override this with the --state-dir flag or the SEEDNET_STATE_DIR environment variable.

seednet --state-dir /var/lib/seednet up "my network"