rockstor / rockstor-core

Linux/BTRFS based Network Attached Storage(NAS)
http://rockstor.com/docs/contribute_section.html
GNU General Public License v3.0
558 stars 138 forks source link

The Rockstor Project

An Open Source (Licensed: FSF Free/Libre & OSI approved) community endeavour to sustainably develop, maintain, and distribute an easy to use, flexible, Linux & BTRFS based DIY Network Attached Storage (NAS) software appliance.

About Us

License:

The Rockstor package code, as distributed, is developed under two main repositories:

Making the package license, as per the Fedora Project Wiki Packaging:LicensingGuidelines:

The optional Rock-ons (Docker Plugins) sub-system uses definitions developed in the rockon-registry which are licensed AGPL-3.0-or-later. These definitions are not included within our distributed package, but retrieved via the internet (from production servers) upon this sub-systems setup.

Note: All additional software installed via the optional Rock-on sub-system is subject to the individual projects licensing terms. As indicated by their respective websites: linked within Rockstors Rock-ons Web-UI.

See the SPDX License List for details on the above assertions.

Documentation

Our Documentation is developed in the open in the rockstor-doc repository and licensed CC-BY-SA-4.0. As with all our code, contributions and corrections are always welcome.

What is Rockstor?

Rockstor is a Network Attached Storage (NAS) solution built on Linux and the B-Tree Filesystem (BTRFS). It is written in Python and Javascript and is made available as a complete Linux distribution for convenience. Rockstor takes NAS to a new level with advanced features, ease of use, and management. It goes beyond traditional NAS by supporting Docker based apps, RESTful APIs; and serves as a private cloud storage platform out-of-the-box.

What are the project goals?

The main goal is to establish sustainable Open Source development of an easy to deploy and use NAS solution for commodity hardware. For more information, see: Our Endeavour.

Who should use it?

The Rockstor Project aims to aid individuals and organisations alike. As a DIY appliance some familiarity with PC/Pi4/ARM64 operating system install is required; but not much beyond the basics. For more information see our main website: rockstor.com

Getting started and questions

The best way to get started is by following the quickstart guide.

To get in touch with developers, users, and contributors join our community forum and ask away.

Troubleshooting

The community forum is the ideal location for help and support; all current developers are also active forum members.

Issue tracking

We use GitHubs issues, although a forum post/discussion is advised beforehand. This often helps with clarifying exactly what any new issue should contain; or in establishing if any existing issue is relevant. It is also important to correctly identify the relevant rockstor repository.

Contributing

Development environment setup and contribution guidelines are available in our docs: Contributing to Rockstor - Overview

There is no Contributor License Agreement (CLA).

Pull requests are welcome. Pick an issue that interests you or create a new one. Reference our friendly community forum for open questions and our ever-growing wiki entries that serve as our community facing developer notes.