132 lines
6.1 KiB
Markdown
132 lines
6.1 KiB
Markdown
# Storj V3 Network
|
|
|
|
[](https://goreportcard.com/report/storj.io/storj)
|
|
[](https://pkg.go.dev/storj.io/storj)
|
|
[](https://build.dev.storj.io/job/storj/job/main/cobertura)
|
|
|
|
|
|
<img src="https://github.com/storj/storj/raw/main/resources/logo.png" width="100">
|
|
|
|
Storj is building a decentralized cloud storage network.
|
|
[Check out our white paper for more info!](https://storj.io/storj.pdf)
|
|
|
|
----
|
|
|
|
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](#contributing-to-storj)
|
|
- [Start using Storj](#start-using-storj)
|
|
- [License](#license)
|
|
- [Support](#support)
|
|
|
|
# Contributing to Storj
|
|
|
|
[](https://sourcerer.io/fame/jtolds/storj/storj/links/0)[](https://sourcerer.io/fame/jtolds/storj/storj/links/1)[](https://sourcerer.io/fame/jtolds/storj/storj/links/2)[](https://sourcerer.io/fame/jtolds/storj/storj/links/3)[](https://sourcerer.io/fame/jtolds/storj/storj/links/4)[](https://sourcerer.io/fame/jtolds/storj/storj/links/5)[](https://sourcerer.io/fame/jtolds/storj/storj/links/6)[](https://sourcerer.io/fame/jtolds/storj/storj/links/7)
|
|
|
|
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)](https://docs.google.com/forms/d/e/1FAIpQLSdVzD5W8rx-J_jLaPuG31nbOzS8yhNIIu4yHvzonji6NeZ4ig/viewform) first. See our [license section](#license) for more details.
|
|
|
|
Have comments or bug reports? Want to propose a PR before hand-crafting it? Jump on to our [forum](https://forum.storj.io) and join the [Engineering Discussions](https://forum.storj.io/c/engineer-amas) 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](https://forum.storj.io/c/parent-cat/5).
|
|
|
|
### Issue tracking and roadmap
|
|
|
|
See the breakdown of what we're building by checking out the following resources:
|
|
|
|
* [White paper](https://storj.io/whitepaper)
|
|
|
|
### 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](https://golang.org).
|
|
|
|
You will also need [Git](https://git-scm.com/). (`brew install git`, `apt-get install git`, etc).
|
|
If you're building on Windows, you also need to install and have [gcc](https://gcc.gnu.org/install/binaries.html) 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.
|
|
|
|
```bash
|
|
git clone git@github.com:<your-username>/storj storj
|
|
cd storj
|
|
```
|
|
|
|
Then, let's install Storj.
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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](https://semver.org/) for our client
|
|
libraries such as [uplink](https://github.com/storj/uplink), we are *not* practicing
|
|
semantic versioning in this repo, as we do not intend for it to be used via
|
|
[Go modules](https://blog.golang.org/using-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](https://github.com/storj/storj/wiki).
|
|
Check out these three tutorials:
|
|
|
|
* [Using the Storj Test Network](https://github.com/storj/storj/wiki/Test-network)
|
|
* [Using the Uplink CLI](https://github.com/storj/storj/wiki/Uplink-CLI)
|
|
* [Using the S3 Gateway](https://github.com/storj/storj/wiki/S3-Gateway)
|
|
|
|
# License
|
|
|
|
The network under construction (this repo) is currently licensed with the
|
|
[AGPLv3](https://www.gnu.org/licenses/agpl-3.0.en.html) license. Once the network
|
|
reaches beta phase, we will be licensing all client-side code via the
|
|
[Apache v2](https://www.apache.org/licenses/LICENSE-2.0) license.
|
|
|
|
For code released under the AGPLv3, we request that contributors sign our
|
|
[Contributor License Agreement (CLA)](https://docs.google.com/forms/d/e/1FAIpQLSdVzD5W8rx-J_jLaPuG31nbOzS8yhNIIu4yHvzonji6NeZ4ig/viewform) 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](https://forum.storj.io/) or file a ticket at
|
|
https://support.storj.io/.
|