Skip to content
Future-proof file sharing platform
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
broker Change case of permissions package constants Mar 15, 2019
cmd Fixing the damn connections Mar 21, 2019
common Fixing closing connection Mar 22, 2019
data Support the encryption in streaming mode Mar 20, 2019
discovery
frontend Simple md viewer implementation Mar 20, 2019
gateway Further fixes for dav Mar 12, 2019
idm
scheduler
tools fixed the ENV and also removed the CELLS_VERSION env on the cells image Dec 13, 2018
vendor Update vendor Mar 14, 2019
.gitattributes Tests on linguist attributes Mar 6, 2019
.gitignore
.travis.yml
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
DEPENDENCIES Update DEPENDENCIES file Sep 24, 2018
LICENSE
Makefile
README.md
crowdin.yml
deps.sh Pydio Cells Apr 21, 2018
dev-imports.go
main.go

README.md

Homepage | Dev Guide | GitHub-Repository | Issue-Tracker

License Badge GoDoc Build Status Go Report Card

Pydio Cells is the nextgen file sharing platform for organizations. It is a full rewrite of the Pydio project using the Go language following a micro-service architecture.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See "Deployment" for notes on how to deploy the project on a live system.

Prerequisites

The following elements are required to compile and run pydio on your machine

  • Go language v1.10 or higher (tested with 1.10.5 and 1.11.5), with a correctly configured Go toolchain,
  • MySQL database 5.6 or higher (or MariaDB equivalent). The new mysql 8 authentication method is supported starting at Cells 1.4.1.

Note: We have developped and tested Pydio Cells on MacOS, Ubuntu, Debian and CentOS. Windows version might still have unknown glitches and is not yet supported.

Installing

Assuming that your system meets the above prerequisites, building the Pydio Cells backend from the source code is quite straight forward:

# Retrieve the code
go get -u github.com/pydio/cells
# From this line on, we assume you are in Pydio Cells' code roots directory
cd $GOPATH/src/github.com/pydio/cells
# Build your binary
make dev

Note: we had to fork a few libraries before integrating them as dependencies. If you need to modify this part of the code, you should first retrieve a local version by executing:

./deps.sh

To have the environment running, you must also:

  • Create a database in your chosen DB server,
  • Run the Pydio Cells installer that will guide you through the necessary steps: you might refer to the wiki for additional information.
./cells install

Running the tests

To run the tests, simply do

go test -v ./...

Please read the CONTRIBUTING.md document if you wish to add more tests or contribute to the code.

Deployment

Binaries are currently provided for Linux and MacOSX distributions. To deploy them on a live system, please see the Installation Guide instructions.

Built With

Pydio Cells uses many open source golang libraries. Most important ones are listed below, please see DEPENDENCIES for an exhaustive list of other libs and their licenses.

  • Micro - Micro-service framework
  • Minio - Objects server implementing s3 protocol

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us. You ca find a comprehensive Developer Guide on our web site. Our online docs are open source as well, feel free to improve them by contributing!

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See the list of contributors who participated in this project. Pydio Cells is also a continuation of the Pydio project and many contributions were ported from pydio-core to the code that can be found under frontend/front-srv/assets.

License

This project is licensed under the AGPLv3 License - see the LICENSE file for details

You can’t perform that action at this time.