Ongoing Storj v3 development. Decentralized cloud object storage that is affordable, easy to use, private, and secure.
aleitner Refactor basystem (#641)
* Signature verification

* Clean up agreement sender to have less errors

* overlay address in captnplanet

* Refactor bandwidth.proto to not use streams

* Make sure the send worked

* Handle connection to satellite

* Save renter public key inside of renter bandwidth allocations

* Default diag to sqlite. Make configurable

* Separate bw server and dbm; regenerate dbx files

* Make sure test uses protobufs

* Demonstrate creating bandwidth allocations
Latest commit 5e93775 Nov 15, 2018
Failed to load latest commit information.
cmd Refactor basystem (#641) Nov 15, 2018
examples Update statdb (#650) Nov 15, 2018
internal Use better defaults and naming for postgres database (#659) Nov 15, 2018
pkg Refactor basystem (#641) Nov 15, 2018
resources give our appearence on windows some love (#429) Oct 16, 2018
scripts Fail linter when copyright is missing. (#664) Nov 15, 2018
storage Use better defaults and naming for postgres database (#659) Nov 15, 2018
test Build and upload binaries (#296) Aug 31, 2018
web/satellite Auth pages markup (#653) Nov 14, 2018
.clabot Adding Faris to the CLA list (#621) Nov 10, 2018
.dockerignore Build and upload binaries (#296) Aug 31, 2018
.gitignore Disconnects nodeclient, routing table dbs when done with kademlia (#507) Oct 26, 2018
.golangci.yml Separate packages in imports (#481) Oct 16, 2018
.travis.yml Use better defaults and naming for postgres database (#659) Nov 15, 2018 styling changes to the code of conduct (#234) Aug 16, 2018
Jenkinsfile Handle release builds and email status (#361) Sep 18, 2018
LICENSE license code with agplv3 (#126) Jul 5, 2018
Makefile Fail linter when copyright is missing. (#664) Nov 15, 2018 Update (#550) Oct 30, 2018 All-in-one docker-compose project (#267) Aug 23, 2018
docker-compose.yaml Use better defaults and naming for postgres database (#659) Nov 15, 2018
go.mod account api: infrastructure, login, register, getUser (#611) Nov 14, 2018
go.sum account api: infrastructure, login, register, getUser (#611) Nov 14, 2018

Storj V3 Network

Go Report Card Go Doc Coverage Status

Storj is building a decentralized cloud storage network. Check out our white paper for more info!

Storj is an S3-compatible platform and suite of decentralized applications that allows you to store data in a secure and decentralized manner. Your files are encrypted, broken into little pieces and stored in a global decentralized network of computers. Luckily, we also support allowing you (and only you) to retrieve those files!

Table of Contents

Contributing to Storj

All of our code for Storj v3 is open source. Have a code change you think would make Storj better? Please send a pull request along! Make sure to sign our Contributor License Agreement (CLA) first. See our license section for more details.

Have comments, bug reports, or suggestions? Want to propose a PR before hand-crafting it? Jump on to our Rocketchat and join the #dev channel to say hi to the developer community and to talk to the Storj core team.

Issue tracking and roadmap

See the breakdown of what we're building by checking out the following resources:

Install required packages

To get started running Storj locally, download and install the latest release of Go (at least Go 1.11) at

You will also need Git. (brew install git, apt-get install git, etc). If you're building on Windows, you also need to install and have gcc setup correctly.

We support Linux, Mac, and Windows operating systems. Other operating systems supported by Go should also be able to run Storj.

Download and compile Storj

Aside about GOPATH: Go 1.11 supports a new feature called Go modules, and Storj has adopted Go module support. If you've used previous Go versions, Go modules no longer require a GOPATH environment variable. Go by default falls back to the old behavior if you check out code inside of the directory referenced by your GOPATH variable, so make sure to use another directory, unset GOPATH entirely, or set GO111MODULE=on before continuing with these instructions.

First, fork our repo and clone your copy of our repository.

git clone<your-username>/storj storj
cd storj

Then, let's install Storj.

go install -v ./cmd/...

Make changes and test

Make the changes you want to see! Once you're done, you can run all of the unit tests:

go test -v ./...

You can also execute only a single test package if you like. For example: go test ./pkg/kademlia. Add -v for more informations about the executed unit tests.

Push up a pull request

Use Git to push your changes to your fork:

git commit -a -m 'my changes!'
git push origin master

Use Github to open a pull request!

Start using Storj

We have another repository dedicated to documentation and tutorials. Check out these three tutorials:


The network under construction (this repo) is currently licensed with the AGPLv3 license. Once the network reaches beta phase, we will be licensing all client-side code via the Apache v2 license.

For code released under the AGPLv3, we request that contributors sign our Contributor License Agreement (CLA) so that we can relicense the code under Apache v2, or other licenses in the future.


If you have any questions or suggestions please reach out to us on Rocketchat or Twitter.