OpenCloud has everything I need... except HEIC/HEIF thumbnails?! And that is why this fork of OpenCloud adds thumbnailing support for extra formats such as HEIC/HEIV/AVIF/JPEGXL. It is intended as a drop-in replacement for the official docker image, while allowing to revert back to the original at any time.
Changes are made on top of the official images to the following components:
thumbnailsservice. To add handling for extra formats mime types.revais patched with updated mime types.- Bundled web assets are patched to register the extra formats mime types to
web-app-previewapp.
Understandably, OpenCloud has concerns shipping HEIC support officially, due to patents around the underlying codecs and consequently libheif. Until they have found a way to get around this limitation i.e. by letting us run our own thumbnailing service easily via configs (without the need for a hard fork), I will be publishing the docker images here on GH packages which is meant for my personal use.
No guarantees will be made when you use this forked image. Upstream syncing is done manually for now and is on best effort basis. You can also maintain this fork fairly easily yourself by rebasing, as the patchsets are pretty small.
Tip
For general information about OpenCloud and how to install please visit OpenCloud on Github and OpenCloud GmbH.
This is the main repository of the OpenCloud server. It contains the golang codebase for the backend services.
The OpenCloud server is released under Apache 2.0. The project is thrilled to receive contributions in all forms. Start hacking now, there are many ways to get involved such as:
- Reporting issues or bugs
- Requesting features
- Writing documentation
- Writing code or extend our tests
- Reviewing code
- Helping others in the community
Every contribution is meaningful and appreciated! Please refer to our Contribution Guidelines if you want to get started.
To build the backend, follow these instructions:
Generate the assets needed by e.g., the web UI and the builtin IDP
make generateThen compile the opencloud binary
make -C opencloud buildThat will produce the binary opencloud/bin/opencloud. It can be started as a local test instance right away with a two step command:
opencloud/bin/opencloud init && opencloud/bin/opencloud serverThis creates a server configuration (by default in $HOME/.opencloud) and starts the server.
For more setup- and installation options consult the Development Documentation.
Important information for contributors about the technology in use.
The OpenCloud backend authenticates users via OpenID Connect using either an external IdP like Keycloak or the embedded LibreGraph Connect identity provider.
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/.
If you find a security-related issue, please contact [email protected] immediately.