OpenCloud

The Go codebase in this repository is the server backend of OpenCloud, a self-hosted file sharing platform. It suits organizations that would rather keep documents on hardware they administer than on a hosted service somewhere they cannot inspect.

The backend makes an unusual storage choice. There is no database at all, and everything is written to the filesystem beneath a root directory that defaults to a folder in the running user's home. Authentication goes through OpenID Connect, using either an external identity provider such as Keycloak or the embedded LibreGraph Connect provider that ships with the server.

Building and running it takes a short sequence of commands.

• Generate assets: a make target produces what the web interface and the built-in identity provider need.
• Compile: a second make target builds a single binary from the source tree.
• Initialize: the init subcommand writes a server configuration before first use.
• Serve: the server subcommand starts a local test instance from that configuration.
• Go further: setup and installation options beyond a local instance live in the development documentation.

The server is Apache 2.0 licensed, and the project openly invites contributions, from reporting bugs and writing documentation to reviewing code, with community discussion on Matrix. Security problems go to a dedicated address rather than the public tracker. Note that this repository is the backend only, so general information about OpenCloud and its installation belongs with the wider organization.