From bf66328369d32deafe9fd584ab6f27396e0345a2 Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Wed, 11 Nov 2026 18:06:40 +0100 Subject: [PATCH 1/2] rework text for better clairification --- docs/admin/configuration/default-language.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/docs/admin/configuration/default-language.md b/docs/admin/configuration/default-language.md index dceb9b419..ac4cc255b 100644 --- a/docs/admin/configuration/default-language.md +++ b/docs/admin/configuration/default-language.md @@ -8,9 +8,11 @@ draft: false # Set the default language -By default, OpenCloud uses English (en) as its interface language, unless a different language is explicitly configured. -OpenCloud relies on ISO 639-1 language codes for language selection. -You can find the complete list of supported languages here: [Supported languages](../resources/faq#miscellaneous) +The system default language applies when a user has not selected an individual language. It is used by the WebUI and services such as notifications and userlog, and can determine the language of notification and invitation emails. If no system default is configured, OpenCloud uses English (`en`). + +Users can select their preferred language in the WebUI under Account > Language. This individual preference takes precedence over the system default. + +OpenCloud uses ISO 639-1 language codes. See [Supported languages](../resources/faq#miscellaneous) for the available languages. If a requested locale includes a territory and no matching translation is available, OpenCloud first tries the base language. If a translation for a user's preferred language is unavailable, OpenCloud falls back to the configured system default and then to English. Without a configured system default, it falls back directly to English. For details, see the [settings service translation rules](../../dev/server/services/settings/information#translation-rules). ## Edit the `.env` File @@ -20,15 +22,14 @@ Open the environment configuration file located in your `opencloud-compose` dire nano opencloud-compose/.env ``` -Configure the default language using the following environment variable: +In `opencloud-compose`, `DEFAULT_LANGUAGE` maps to `OC_DEFAULT_LANGUAGE` inside the OpenCloud container. Set the system default to German, for example: ```env -# The default language used by services and the WebUI. -# Uses ISO 639-1 language codes (e.g. "en", "de", "fr"). -# Defaults to English if not set. -DEFAULT_LANGUAGE="language code" +DEFAULT_LANGUAGE=de ``` +When configuring OpenCloud directly without `opencloud-compose`, set `OC_DEFAULT_LANGUAGE=de` instead. + ## Restart Docker Services After saving the file, shut down and restart the Docker containers to apply the changes: @@ -40,4 +41,4 @@ docker compose up -d ## Result -OpenCloud is now fully displayed in the language configured in the .env file. +The configured language is now the system default. It applies to users without an individual language preference and to services that use the default language. A user's language selected under Account > Language takes precedence. If translations are unavailable or incomplete, OpenCloud applies the fallback behavior described above, so some text can appear in English. From faab8cbf40e221f9079255b5d3241eb51d230f8b Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Thu, 12 Nov 2026 08:11:18 +0100 Subject: [PATCH 2/2] refine yjs version --- docs/admin/configuration/collaborative-editing.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/admin/configuration/collaborative-editing.md b/docs/admin/configuration/collaborative-editing.md index 39ee3c07b..f38bb909e 100644 --- a/docs/admin/configuration/collaborative-editing.md +++ b/docs/admin/configuration/collaborative-editing.md @@ -46,12 +46,12 @@ This launches an additional container (called `yjs`) using the `opencloudeu/yjs` All options are set in the `.env` file. All of them are optional. -| Variable | Description | Default | -| ------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ----------------------- | -| `YJS_DOCKER_IMAGE` | Docker image for the yjs container. | `opencloudeu/yjs` | -| `YJS_DOCKER_TAG` | Docker tag for the yjs container. | `1.0.0` | -| `YJS_OPENCLOUD_URL` | URL the yjs server uses to reach OpenCloud. This is an internal address, so no TLS is used between the containers. | `http://opencloud:9200` | -| `YJS_SHUTDOWN_GRACE_PERIOD_MS` | Grace period in milliseconds for a graceful shutdown. Keep it below the `stop_grace_period` set in `yjs/yjs.yml`. | `15000` | +| Variable | Description | Default | +| ------------------------------ | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- | +| `YJS_DOCKER_IMAGE` | Docker image for the yjs container. | `opencloudeu/yjs` | +| `YJS_DOCKER_TAG` | Docker tag for the yjs container. The default is defined in Compose and may change between releases. | [Current Compose default](https://github.com/opencloud-eu/opencloud-compose/blob/main/yjs/yjs.yml) | +| `YJS_OPENCLOUD_URL` | URL the yjs server uses to reach OpenCloud. This is an internal address, so no TLS is used between the containers. | `http://opencloud:9200` | +| `YJS_SHUTDOWN_GRACE_PERIOD_MS` | Grace period in milliseconds for a graceful shutdown. Keep it below the `stop_grace_period` set in `yjs/yjs.yml`. | `15000` | The OpenCloud web frontend gets the address of the yjs server through the `WEB_OPTION_YJS_SERVER_URL` variable. The `yjs/yjs.yml` compose file sets this for you. Collaborative editing stays disabled as long as this variable is empty.