Skip to content

rework text for better clairification #1345

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Svanvith merged 1 commit into from
Nov 12, 2026
Merged

rework text for better clairification #1345

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 10 additions & 9 deletions docs/admin/configuration/default-language.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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:
Expand All @@ -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.
Loading