Skip to content

Running a Local Subspace Chain

This guide explains how to set up and run a local Subspace blockchain node, noting that its storage may differ slightly from the mainnet.

Steps

  1. Clone the Repository

    First, clone the Subspace blockchain node repository:

    Terminal window
    git clone https://github.com/renlabs/torus-blockchain
    cd subspace
  2. Build the Project

    Compile the project using Cargo:

    Terminal window
    cargo build --release

    Optional: If you want to include the testnet faucet, use:

    Terminal window
    cargo build --release --features testnet-faucet
  3. Run the Node

    Start your local node:

    Terminal window
    cargo xtask run --alice

    You can also run a second node with:

    Terminal window
    cargo xtask run --bob
  4. Connect to Your Node

    Once the node is running, you can connect to it at:

    ws://localhost:9951

Additional Information

  • The --alice and --bob flags are used to run predefined validator nodes.
  • You can customize your node’s configuration by modifying the appropriate files in the project.