Install
There are no ready-made downloads or apps yet. For now SmartNodes is built from source on Linux. Apps for Windows, macOS, Android and iPhone come later.
The programs
| Program | Who needs it | What it does |
|---|---|---|
smartvpn | Users | The VPN client: connects through two hops, buys and uses bridges, flags bad nodes. |
smartnode | Node operators | Runs an entry, exit or bridge node. |
smartnodesd | Everyone who talks to the chain | The chain itself, and the command line for chain transactions and queries. |
smartprobe | Probers | Tests the nodes the chain assigns, and reports results. |
ticketctl | Test network only | Makes test ticket wallets and test issuer keys. It must never be used for anything of value. |
What you need
- A 64-bit Linux machine with root access and a kernel from 5.6 on, which has WireGuard built in.
- Go 1.26 or newer, and
git. - For the client and nodes:
wireguard-tools,iproute2andiptables. The kernel's built-in WireGuard is used. - For the disguise and bridges: Xray.
jqandcurl, which the examples use.
sudo apt update
sudo apt install -y git wireguard-tools iproute2 iptables jq curl
Build from source
git clone https://github.com/mspvantage/smartnodes.git
cd smartnodes
go build -o bin/ ./cmd/...
sudo install -m 0755 bin/* /usr/local/bin/
This builds all five programs into bin/ and copies them to /usr/local/bin. It takes a few minutes the first time, while Go downloads what the code depends on.
Install Xray
Only needed for the disguise, bridges and probing disguised nodes. Download the Linux release for your machine from the Xray releases page, check its checksum, and put the xray program in /usr/local/bin:
unzip Xray-linux-64.zip xray
sudo install -m 0755 xray /usr/local/bin/xray
xray version
Check it worked
smartnodesd version
smartvpn # prints its commands
smartnode -h # prints its options
Updating
cd smartnodes
git pull
go build -o bin/ ./cmd/...
sudo install -m 0755 bin/* /usr/local/bin/
Restart any running node or client afterwards. While the network is in testing, an update can change the chain's rules, and the test chain may be restarted from scratch.