Skip to main content
Version: Pre-Release

Install

Get Started with Pulsar

Pulsar (formerly Subspace CLI) is our recommended tool for farming on the Subspace Network. This ALPHA SOFTWARE is constantly evolving, and your feedback is invaluable in this process. To share your insights, please fill out this feedback form. For detailed guidance, follow the guide below and check out the README on GitHub. Should you encounter any issues, feel free to file bug reports on our GitHub.

Prefer a video? Click here for an installation tutorial.
caution

Please note that some older processors/VMs are no longer supported by official releases, but can still be compiled manually if needed. Precompiled versions of Pulsar are hosted on GitHub. Find the appropriate binary for your operating system below.

Get Started with Pulsar Installation

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 Pulsar Executable​

Pulsar Executable(Legacy CPU)Pulsar Executable(Skylake+ CPU)

Step 2: Initialize Pulsar​

We will now initialize Pulsar. This is where we will configure Reward Address, Plot Size, Plot Location, etc.

  1. Open Powershell, type cd Downloads (or cd Your-File-Location).
  2. Execute the init command as seen below.
./pulsar-windows-x86_64-skylake-v0.7.2-alpha.exe init
  1. This will prompt you to setup your Pulsar configurations to begin farming. You should see a similar prompt like so:
Configuration creation process has started...
Do you have an existing farmer/reward address? [y/n]: y
Enter your farmer/reward address: REDACTED_ADDRESS
Enter your node name to be identified on the network (defaults to `username`, press enter to use the default):
Specify a path for storing plot files (press enter to use the default: `"/home/username/.local/share/pulsar/farms"`):
Specify a path for storing node files (press enter to use the default: `"/home/username/.local/share/pulsar/node"`):
Specify a plot size (defaults to `2.0 GB`, press enter to use the default):
Specify the chain to farm. Available options are: [Gemini3g, Dev, DevNet].
Defaults to `Gemini3g`, press enter to use the default:
Configuration has been generated at /home/username/.config/pulsar
Ready for lift off! Run the follow command to begin: `"path/to/executable" farm`
  1. Once complete, the settings will be written to the settings.toml. You can find Your settings.toml in $FOLDERID_RoamingAppData/pulsar/settings.toml

Step 3. Start Farming with Pulsar​

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

We will now start the farmer with the farm command

  1. Run the following command below to start farming with Pulsar. 
./pulsar-windows-x86_64-skylake-v0.7.2-alpha.exe farm
  1. You should see the farmer and node start successfully and begin syncing, plotting, and then farming:
Starting node ... (this might take up to couple of minutes)
Node started successfully!
Starting farmer ...
Farmer started successfully!
Initial plotting for plot: #0 (/home/username/.local/share/pulsar/farms)
⠁ [00:00:00] 3% [=>                                      ]
      (31.00 MiB/953.67 MiB) 157.35 GiB/s, plotting, ETA: 0s
  1. That's it! Enjoy and Happy Farming!