joystream/storage-node

This repository contains several Node packages, located under the packages/ subdirectory. See each individual package for details:

• colossus - the main colossus app.
• storage-node-backend - abstraction over the storage backend.
• storage-runtime-api - convenience wrappers for the runtime API.
• storage-utils - general utility functions.
• discovery - service discovery using IPNS.
• storage-cli - cli for uploading and downloading content from the network
• helios - cli tool for getting status of storage network

Installation

Requirements

This project uses yarn as Node package manager. It also uses some node packages with native components, so make sure to install your system's basic build tools.

On Debian-based systems:

$ apt install build-essential

On Mac OS (using homebrew):

$ brew install libtool automake autoconf

Building

$ yarn install

The command will install dependencies, and make a colossus executable available:

$ yarn colossus --help

Testing

Run an ipfs node and a joystream-node development chain (in separate terminals)

ipfs daemon

joystream-node --dev

$ yarn workspace storage-node test

Running a development environment, after starting the ipfs node and development chain

yarn storage-cli dev-init

This will configure the running chain with alice as the storage lead and with a known role key for the storage provider.

Run colossus in development mode:

yarn colossus --dev

Start pioneer ui:

yarn workspace pioneer start

Browse pioneer on http://localhost:3000/ You should find Alice account is the storage working group lead and is a storage provider Create a media channel. And upload a file. You may have to wait a couple of minutes before the ipns of the storage-node is registered before you can upload a file, or you will get an error in pioneer.

Detailed Setup and Configuration Guide

For details on how to setup a storage node on the Joystream network, follow this step by step guide.