opencloudeu/opencloud

!https://raw.githubusercontent.com/opencloud-eu/opencloud/refs/heads/main/opencloud_logo.png

![status-badge]([] ![Matrix]([] ![License]([***]

Server Backend

[!TIP] For general information about OpenCloud and how to install please visit https://github.com/opencloud-eu/ and OpenCloud GmbH.

This is the main repository of the OpenCloud server. It contains the golang codebase for the backend services.

Getting Involved

The OpenCloud server is released under https://github.com/opencloud-eu/opencloud/blob/main/LICENSE. The project is thrilled to receive contributions in all forms. Start hacking now, there are many ways to get involved such as:

• Reporting https://github.com/opencloud-eu/opencloud/issues
• Requesting https://github.com/opencloud-eu/opencloud/issues
• https://github.com/opencloud-eu/docs
• https://github.com/opencloud-eu/opencloud/pulls
• https://github.com/opencloud-eu/opencloud/pulls
• Helping others in the community

Every contribution is meaningful and appreciated! Please refer to our https://github.com/opencloud-eu/opencloud/blob/main/CONTRIBUTING.md if you want to get started.

Build OpenCloud

To build the backend, follow these instructions:

Generate the assets needed by e.g., the web UI and the builtin IDP

console
make generate

Then compile the opencloud binary

console
make -C opencloud build

That will produce the binary opencloud/bin/opencloud. It can be started as a local test instance right away with a two step command:

bash
opencloud/bin/opencloud init && opencloud/bin/opencloud server

This creates a server configuration (by default in $HOME/.opencloud) and starts the server.

For more setup- and installation options consult the Development Documentation.

Technology

Important information for contributors about the technology in use.

Authentication

The OpenCloud backend authenticates users via OpenID Connect using either an external IdP like Keycloak or the embedded https://github.com/libregraph/lico identity provider.

Database

The OpenCloud backend does not use a database. It stores all data in the filesystem. By default, the root directory of the backend is $HOME/.opencloud/.

Security

If you find a security-related issue, please contact *** immediately.