Skip to content
This repository has been archived by the owner on Jul 30, 2020. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

 Nodes for Joystream

Joystream Full Node

Joystream node built with Substrate.

Follow the instructions below to download the software or build it from source.

For setting up a full node and valiador review the advanced guide from the helpdesk.

Binary releases

The latest pre build binaries can be downloads from the releases page.

Building from source

Initial setup

If you want to build from source you will need the Rust toolchain, openssl and llvm/libclang. You can install the required dependencies with:

git clone
cd substrate-node-joystream/
git checkout v2.1.2

If you are familiar with docker see the building with docker section.


cargo build --release

Running a public node on the Rome testnet

Run the node and connect to the public testnet.

cargo run --release -- --chain ./rome-tesnet.json

The rome-testnet.json chain file can be ontained from the release page

Installing a release build

This will install the executable joystream-node to your ~/.cargo/bin folder, which you would normally have in your $PATH environment.

cargo install --path ./

Now you can run

joystream-node --chain rome-testnet.json


Running a local development node

cargo run --release -- --dev

Cleaning development chain data

When making changes to the runtime library remember to purge the chain after rebuilding the node to test the new runtime.

cargo run --release -- purge-chain --dev


Building localy

A joystream-node can be compiled with given Dockerfile file:

# Build and tag a new image, which will compile joystream-node from source
docker build . -t joystream-node

# run a development chain with the image just created publishing the websocket port
docker run -p 9944:9944 joystream-node --dev --ws-external

Downloading joystream pre-built images from Docker Hub

docker pull joystream/node

Running a public node as a service

Create a working directory to store the node's data and where you will need to place the chain file.

mkdir ${HOME}/joystream-node-data/

cp rome-testnet.json ${HOME}/joystream-node-data/

docker run -d -p 30333:30333 \
    -v ${HOME}/joystream-node-data/:/data \
    --name my-node \
    joystream/node --base-path /data --chain /data/rome-testnet.json

# check status
docker ps

# monitor logs
docker logs --tail 100 -f my-node