From f420e45e73a32e44e56f5c6de5e876ede2289add Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Wed, 11 Mar 2026 12:30:44 +0100 Subject: [PATCH] write instruction how to eneable MS-Office formats in the new button and put together collabora related docs in a new collabora folder --- .../configuration/collabora/_category_.json | 4 + .../collabora-fonts.md} | 8 +- .../collabora/collabora-ms-office-formats.md | 112 ++++++++++++++++++ .../configuration/frontend-update-check.md | 2 +- 4 files changed, 121 insertions(+), 5 deletions(-) create mode 100644 docs/admin/configuration/collabora/_category_.json rename docs/admin/configuration/{collabora.md => collabora/collabora-fonts.md} (82%) create mode 100644 docs/admin/configuration/collabora/collabora-ms-office-formats.md diff --git a/docs/admin/configuration/collabora/_category_.json b/docs/admin/configuration/collabora/_category_.json new file mode 100644 index 00000000..3607b364 --- /dev/null +++ b/docs/admin/configuration/collabora/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Collabora", + "position": 30 +} diff --git a/docs/admin/configuration/collabora.md b/docs/admin/configuration/collabora/collabora-fonts.md similarity index 82% rename from docs/admin/configuration/collabora.md rename to docs/admin/configuration/collabora/collabora-fonts.md index c888fae2..c175632d 100644 --- a/docs/admin/configuration/collabora.md +++ b/docs/admin/configuration/collabora/collabora-fonts.md @@ -1,6 +1,6 @@ --- -sidebar_position: 70 -id: collabora +sidebar_position: 10 +id: collabora-fonts title: Collabora additional fonts description: How to add additional fonts to Collabora draft: false @@ -29,7 +29,7 @@ apt install ttf-mscorefonts-installer During the installation, you will be prompted to accept the EULA (End User License Agreement). -Accept EULA +Accept EULA ## 3. Restart Collabora @@ -41,4 +41,4 @@ docker compose restart Once restarted, Collabora will recognize the newly installed fonts, and they will be available when editing documents. -New Fonts added +New Fonts added diff --git a/docs/admin/configuration/collabora/collabora-ms-office-formats.md b/docs/admin/configuration/collabora/collabora-ms-office-formats.md new file mode 100644 index 00000000..716c2c6c --- /dev/null +++ b/docs/admin/configuration/collabora/collabora-ms-office-formats.md @@ -0,0 +1,112 @@ +--- +sidebar_position: 20 +id: collabora-ms-office-formats +title: Enable MS-Office formats +description: How to enable MS-Office formats +draft: false +--- + +## Enable Microsoft file formats in the New menu + +:::note +Starting with version 5.2.0, OpenCloud no longer enables Microsoft file formats as default creation options in the New menu. To make them available again, you must define them explicitly in `app-registry.yaml`. +::: + +### Create the configuration file + +Create an `app-registry.yaml` file in your `config/opencloud` directory. + +If your deployment uses a bind mount for the OpenCloud configuration, place the file in the corresponding directory on the host system. In that case, use the path from your own Docker Compose setup rather than `config/opencloud`. + +```bash +config/opencloud/app-registry.yaml +``` + +Insert following content: + +```yaml +app_registry: + mimetypes: + - mime_type: application/pdf + extension: pdf + name: PDF + description: PDF document + icon: '' + default_app: '' + allow_creation: false + - mime_type: application/vnd.oasis.opendocument.text + extension: odt + name: Document + description: OpenDocument text document + icon: '' + default_app: Collabora + allow_creation: true + - mime_type: application/vnd.oasis.opendocument.spreadsheet + extension: ods + name: Spreadsheet + description: OpenDocument spreadsheet document + icon: '' + default_app: Collabora + allow_creation: true + - mime_type: application/vnd.oasis.opendocument.presentation + extension: odp + name: Presentation + description: OpenDocument presentation document + icon: '' + default_app: Collabora + allow_creation: true + - mime_type: application/vnd.openxmlformats-officedocument.wordprocessingml.document + extension: docx + name: Microsoft Word + description: Microsoft Word document + icon: '' + default_app: Collabora + allow_creation: true + - mime_type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet + extension: xlsx + name: Microsoft Excel + description: Microsoft Excel document + icon: '' + default_app: Collabora + allow_creation: true + - mime_type: application/vnd.openxmlformats-officedocument.presentationml.presentation + extension: pptx + name: Microsoft PowerPoint + description: Microsoft PowerPoint document + icon: '' + default_app: Collabora + allow_creation: true + - mime_type: application/vnd.jupyter + extension: ipynb + name: Jupyter Notebook + description: Jupyter Notebook + icon: '' + default_app: '' + allow_creation: true +``` + +### Verify ownership and permissions + +:::important UID/GID and volume permissions +Make sure that `app-registry.yaml` can be read by the user running the OpenCloud container. Incorrect ownership or permissions on mounted files can prevent OpenCloud from using the configuration. +::: + +By default, OpenCloud uses: + +```bash +UID=1000 +GID=1000 +``` + +Adjust the file ownership and permissions if your container runs with different values. + +### Restart OpenCloud + +Restart your deployment after creating the file: + +```bash +docker compose down +docker compose up -d +``` + +After the restart, Microsoft formats such as Word, Excel, and PowerPoint are available again in the New menu. diff --git a/docs/admin/configuration/frontend-update-check.md b/docs/admin/configuration/frontend-update-check.md index f35e5e4b..0fcb93c0 100644 --- a/docs/admin/configuration/frontend-update-check.md +++ b/docs/admin/configuration/frontend-update-check.md @@ -1,5 +1,5 @@ --- -sidebar_position: 15 +sidebar_position: 35 id: frontend-check-updates title: Frontend Update check description: How to disable the frontend check for updates in OpenCloud.