The Storj Developer Hub

Welcome to the Storj developer hub. You'll find comprehensive guides and documentation to help you start working with Storj as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Support

Getting Started

1. Create an Account

This part is really simple:

  1. Sign Up for a Storj account.
  2. Click on the activation link sent to your email.
  3. Now visit app.storj.io to login.

2. Creating a Bucket

We have lots of cat pictures we want to store in the cloud, so we should create a bucket. A bucket is just a logical grouping of files that we can assign permissions and limits to.

  1. Click on the big green "Create Bucket" button.
  2. Give it a descriptive name like "Bucket of Cats". Don't worry, you can rename this later.

3. Getting Some Tools

We currently have a Javascript and Node.js client written to interface with the network and API. You must have Node.js and npm installed. We HIGHLY recommend nvm for this. This tutorial is using a default Ubuntu 14.04 x64 machine from Digital Ocean.

apt-get install git -y
npm install -g storj
# why are you running this as root?
apt-get install git -y
npm install -g storj --unsafe-perm
# download and install nvm
wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.31.1/install.sh | bash
# restart your shell

# install node
nvm install 4.4.5 

Run the storj program to view usage:

storj --help

4. Pairing a Device with Your Account

Passwords suck so we like to avoid them when we can. Behind the scenes, we use super secure ECDSA keys that would take a computer the size of the sun to crack (provided you keep your keys safe).

To make this process simple, we created a pairing process. This will create a keypair on your computer and send the public key to us. It will be used for further authentication instead of the username and password.

$ storj login
 [...]  > Enter your email address  >  cats@storj.io
 [...]  > Enter your password  >  ********************

 [info]   This device has been successfully paired.

Up Next: Upload/Download Cat Pictures

Getting Started