Go to file
Michał Niewrzał 12402eb729 Merge remote-tracking branch 'origin/main' into multipart-upload
Change-Id: I38adf8218c1415c7ea1910f8bd6bed13544b0f03
2021-02-17 08:50:38 +01:00
.github all: switch from master to main 2020-12-28 22:59:06 +01:00
certificate pkg/server,pkg/quic: accept an existing conn to create quic listener and 2021-02-03 12:04:29 -05:00
cmd Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-17 08:50:38 +01:00
docs docs: change 'offline score' to 'online score' in downtime tracking doc 2020-12-29 15:31:20 +00:00
installer/windows storagenode/windows-installer: ignore set firewall exception error 2020-05-27 17:56:49 +03:00
multinode multinode/multinodedb: add sqlite3 support 2021-02-11 16:36:05 +00:00
pkg pkg/server: implement hybrid connector for tcp fallback 2021-02-03 14:22:50 -05:00
private Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-17 08:50:38 +01:00
resources cmd: add ca-certificates to Docker images (#3986) 2020-12-08 01:38:33 +01:00
satellite Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-17 08:50:38 +01:00
scripts satellite/metainfo: fix for getting real RS values 2021-02-16 17:26:09 +01:00
storage satellite/accounting/live: Use Redis client directly 2021-01-12 15:33:29 +01:00
storagenode Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-11 11:48:23 +01:00
versioncontrol versioncontrol: add process url resolver 2021-01-15 17:11:08 +00:00
web Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-17 08:50:38 +01:00
.dockerignore Forward-port release-alpha8 build script issues (#1726) 2019-04-09 23:01:10 -06:00
.gitignore satellite/console/wasm: reduce size to <9MB 2020-12-14 16:41:39 +00:00
CODE_OF_CONDUCT.md Adding CODE_OF_CONDUCT to storj/storj repo (#779) 2018-12-07 15:10:02 -05:00
docker-compose.yaml satellite/testing: Change testing to use PG 12.3 (#3913) 2020-06-25 20:17:39 +03:00
go.mod Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-17 08:50:38 +01:00
go.sum Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-17 08:50:38 +01:00
Jenkinsfile Makefile: update to go v1.15.7 (#4026) 2021-01-20 19:08:35 +01:00
Jenkinsfile.public metainfo-migration: extend test case 2021-02-11 19:28:41 +01:00
LICENSE license code with agplv3 (#126) 2018-07-05 10:24:26 -04:00
Makefile Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-01 14:32:12 +02:00
monkit.lock Merge remote-tracking branch 'origin/main' into multipart-upload 2021-02-02 19:19:04 +02:00
package-lock.json Satellite api keys frontend (#1039) 2019-02-01 18:19:30 +02:00
README.md quick update to readme (#4033) 2021-01-28 10:16:57 -05:00

Storj V3 Network

Go Report Card Go Doc Coverage Status Alpha

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 or bug reports? Want to propose a PR before hand-crafting it? Jump on to our forum and join the Engineering Discussions to say hi to the developer community and to talk to the Storj core team.

Want to vote on or suggest new features? Post it on the forum.

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.13) at golang.org.

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 git@github.com:<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/identity. 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 main

Use Github to open a pull request!

A Note about Versioning

While we are practicing semantic versioning for our client libraries such as uplink, we are not practicing semantic versioning in this repo, as we do not intend for it to be used via Go modules. We may have backwards-incompatible changes between minor and patch releases in this repo.

Start using Storj

Our wiki has documentation and tutorials. Check out these three tutorials:

License

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.

Support

If you have any questions or suggestions please reach out to us on our community forum or email us at support@tardigrade.io.