Skip to main content
Version: latest

Install

tip

Releases section on our GitHub is the best place to get fresh releases of binaries and check out the source code.

Multiple Versions

There are multiple versions of our releases available below. Skylake: For Intel Skylake onwards and AMD Ryzen CPUs. Typically those PCs manufactured after 2015. Legacy (x86-64-v2): For Intel Broadwell, Haswell and older CPUs, as well as AMD's equivalents. Designed for the CPU architecture generally found in systems produced between 2009 and 2015. Also supports VM environments that do not expose the Skylake onwards instructions.

Get Started with Advanced CLI Installation​

We will download two files for your respective operating system.

  1. Subspace-Node - This is the executable that actually makes the connection with the Subspace Network
  2. Subspace-Farmer - This is the executable that will actually farm for rewards on your allocated storage plots.
note

Starting with the February 19th release, we've enhanced plotting performance by increasing internal concurrency. This enhancement leads to improved CPU utilization and increased RAM usage. If you prefer to revert your farmer to its previous behavior, you can use the flag --record-encoding-concurrency 1.

Windows Specific Warnings:​

Windows No Output Bug

If you face an error where the node outputs nothing and no error code is given it is likely you just need to install the latest Visual C++ Redistributable package here

Step 1: Download the Advanced CLI Executables​

Node Executable(Skylake+ CPU)Farmer Executable(Skylake+ CPU)
Node Executable(Legacy CPU)Farmer Executable(Legacy CPU)

Step 2: Start Advanced CLI Node​

danger

A Windows Defender Firewall has blocked some features of this app warning may appear. This is because the application is trying to access the internet. This is expected as it is how the farmer talks to other farmers on the network, select Allow access to continue setup.

  1. Open Powershell (we do not recommend using Command Prompt as its syntax is slightly different)
  2. In the terminal we will change to the Downloads directory using this command cd Downloads
  3. We will then start the node using the following command:
# Replace `INSERT_YOUR_ID` with a nickname you choose
# Copy all of the lines below, they are all part of the same command
.\subspace-node-windows-x86_64-skylake-gemini-3h-2024-apr-26-2.exe `
  run `
  --chain gemini-3h `
  --base-path NODE_DATA_PATH `
  --farmer `
  --name "INSERT_YOUR_ID"
note

Using run, setting --base-path and specifying --chain became mandatory starting with Gemini 3h. The parameter --validator was switched to --farmer at the same time.

  1. You should see something similar in the terminal:
2022-02-03 10:52:23 Subspace
2022-02-03 10:52:23 ✌️  version 0.1.0-35cf6f5-x86_64-windows
2022-02-03 10:52:23 ❤️  by Subspace Labs <https://subspace.network>, 2021-2022
2022-02-03 10:52:23 📋 Chain specification: Subspace Gemini 1
2022-02-03 10:52:23 🏷  Node name: YOUR_FANCY_NAME
2022-02-03 10:52:23 👤 Role: AUTHORITY
2022-02-03 10:52:23 💾 Database: RocksDb at C:\Users\X\AppData\Local\subspace-node-windows-x86_64-snapshot-2022-jan-05.exe\data\chains\subspace_test\db\full
2022-02-03 10:52:23 ⛓  Native runtime: subspace-100 (subspace-1.tx1.au1)
2022-02-03 10:52:23 🔨 Initializing Genesis block/state (state: 0x22a5…17ea, header-hash: 0x6ada…0d38)
2022-02-03 10:52:24 ⏱  Loaded block-time = 1s from block 0x6ada0792ea62bf3501abc87d92e1ce0e78ddefba66f02973de54144d12ed0d38
2022-02-03 10:52:24 Starting archiving from genesis
2022-02-03 10:52:24 Archiving already produced blocks 0..=0
2022-02-03 10:52:24 🏷  Local node identity is: 12D3KooWBgKtea7MVvraeNyxdPF935pToq1x9VjR1rDeNH1qecXu
2022-02-03 10:52:24 🧑‍🌾 Starting Subspace Authorship worker
2022-02-03 10:52:24 📦 Highest known block at #0
2022-02-03 10:52:24 〽️ Prometheus exporter started at 127.0.0.1:9615
2022-02-03 10:52:24 Listening for new connections on 0.0.0.0:9944.
2022-02-03 10:52:26 🔍 Discovered new external address for our node: /ip4/176.233.17.199/tcp/30333/p2p/12D3KooWBgKtea7MVvraeNyxdPF935pToq1x9VjR1rDeNH1qecXu
2022-02-03 10:52:29 ⚙️  Syncing, target=#215883 (2 peers), best: #55 (0xafc7…bccf), finalized #0 (0x6ada…0d38), ⬇ 850.1kiB/s ⬆ 1.5kiB/s

Step 3: Start Advanced CLI Farmer​

  1. We will then open another terminal, change to the downloads directory as we did before, then start the farmer node with the following command:
  # Replace `PATH_TO_FARM` with location where you want you store plot files
  # Replace `WALLET_ADDRESS` below with your account address from Polkadot.js wallet
  # Replace `PLOT_SIZE` with plot size in gigabytes or terabytes, for example 100G or 2T (but leave at least 60G of disk space for node and some for OS)
  .\subspace-farmer-windows-x86_64-skylake-gemini-3h-2024-apr-26-2.exe farm --reward-address WALLET_ADDRESS path=PATH_TO_FARM,size=PLOT_SIZE
  1. You should see something similar in the terminal:
2022-06-02T00:02:04.552120Z  INFO subspace_farmer::commands::farm: Connecting to node at ws://127.0.0.1:9944
2022-06-02T00:02:04.557220Z  INFO jsonrpsee_client_transport::ws: Connection established to target: Target { sockaddrs: [], host: "127.0.0.1", host_header: "127.0.0.1:9944", _mode: Plain, path_and_query: "/" }
2022-06-02T00:02:04.575669Z  INFO subspace_farmer::commands::farm: Opening object mapping
2022-06-02T00:02:04.617553Z  INFO subspace_farmer::multi_farming: Opening plot
2022-06-02T00:02:04.645422Z  INFO subspace_farmer::multi_farming: Opening commitments
2022-06-02T00:02:04.666925Z  INFO subspace_farmer::farming: Subscribing to slot info notifications
2022-06-02T00:02:04.688218Z  INFO subspace_farmer::archiving: Subscribing to archived segments
2022-06-02T00:02:04.689129Z  INFO subspace_farmer::commands::farm: WS RPC server listening on 127.0.0.1:9955
2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=0
2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=1
2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=2
2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=3
2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=4
2022-06-02T00:02:09.492868Z  INFO subspace_farmer::archiving: Plotted segment segment_index=5
  1. You are now farming! Just wait for your node to fully sync, and for your farmer to fully plot.
Feedback!

Your insights on our releases elevate our progress. Fill out this form, your voice will be heard and addressed.

Learn More About Syncing, Plotting & Farming

If you would like to learn more about how the syncing, plotting and farming processes works on the Subspace Network, please refer to our Subnomicon links below. Synchronization
Plotting
Farming