Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
75 changes: 75 additions & 0 deletions docs/admin/maintenance/upgrade/upgrade-9.x.x.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
sidebar_position: 14
id: upgrade-9.x.x
title: Upgrade 9.x.x
description: Upgrading to OpenCloud 9.x.x
draft: false
---

# Upgrading to OpenCloud 9.x.x

OpenCloud 9.x.x adds guest links and moves thumbnail generation into the webdav service. Complete the regular upgrade first by following the [Standard Upgrade Guide](./upgrade.md).

:::important

OpenCloud 9.x.x is a Rolling release and is not intended for production environments. For more information, see the [Release Lifecycle](../../resources/lifecycle.md).

:::

## Quick upgrade

Set the new version in your `.env` (`OC_DOCKER_TAG`) and restart:

```bash
docker compose pull opencloud
docker compose up -d
```

OpenCloud 9.x.x starts with the existing 8.x.x configuration. Guest links stay disabled until you enable them.

## Thumbnails

Existing previews keep working.

- The cache moves to `thumbnails/cache` and is created automatically. The old `thumbnails/files` folder is no longer used and can be removed:

```bash
docker compose exec opencloud rm -r /var/lib/opencloud/thumbnails/files
```

If you configured a custom `OC_BASE_DATA_PATH`, replace `/var/lib/opencloud` with the configured path.

- Sizes are edge lengths, rounded up per axis, with a maximum of 2048 px.
- Old `THUMBNAILS_*` variable names are still read. Removed ones are ignored.
- YAML keys are **not** read from the old place. If you set thumbnail settings in `opencloud.yaml`, move them to `webdav: thumbnails:` before restarting.
- If services run in separate containers, set `WEBDAV_THUMBNAILS_GENERATOR_URL=http://thumbnails:9186`.

Details: [webdav MIGRATION.md](https://github.com/opencloud-eu/opencloud/blob/main/services/webdav/MIGRATION.md).

## Guest links

Guest links are disabled by default. To enable them, migrate the configuration first. Open a shell in the config volume:

```bash
docker run --rm -it --user 1000:1000 --entrypoint /bin/sh \
-v <opencloud-config-volume>:/etc/opencloud \
opencloudeu/opencloud-rolling:9.0.0
```

Replace `<opencloud-config-volume>` with the Docker volume or bind mount that contains your OpenCloud configuration.

Inside the container, create and apply the patch:

```bash
cd /etc/opencloud
opencloud init --diff
patch opencloud.yaml < opencloud.config.patch
```

The patch adds `auth_guest.service_account` and removes `thumbnails.thumbnail`.

Then set `OC_ENABLE_GUEST_LINKS=true`, configure SMTP for the notifications service and restart OpenCloud. Guests get their link and PIN by email.

## Space quota

If `GRAPH_SPACES_DEFAULT_QUOTA` is set, rename it to `OC_SPACES_DEFAULT_QUOTA`. The `spaces.default_quota` capability reads only the new name, so clients see the default 1 GB otherwise.
2 changes: 1 addition & 1 deletion docs/admin/resources/lifecycle.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ With LTS, businesses can continue using an older production release without need
<TabItem value="rolling" label="Rolling" default>
| Version | Release Date | Release Notes & Download|
|:--------|:-------------|:--------------|
| v8.2.0 | TBD | TBD |
| v9.0.0 | 2026 October 27 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v9.0.0) |
| v8.1.0 | 2026 October 5 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.1.0) |
| v8.0.1 | 2026 September 16 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.0.1) |
| v8.0.0 | 2026 September 15 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.0.0) |
Expand Down
2 changes: 1 addition & 1 deletion versioned_docs/version-4.0/admin/resources/lifecycle.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ With LTS, businesses can continue using an older production release without need
<TabItem value="rolling" label="Rolling" default>
| Version | Release Date | Release Notes & Download|
|:--------|:-------------|:--------------|
| v8.2.0 | TBD | TBD |
| v9.0.0 | 2026 October 27 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v9.0.0) |
| v8.1.0 | 2026 October 5 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.1.0) |
| v8.0.1 | 2026 September 16 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.0.1) |
| v8.0.0 | 2026 September 15 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.0.0) |
Expand Down
2 changes: 1 addition & 1 deletion versioned_docs/version-7.2/admin/resources/lifecycle.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ With LTS, businesses can continue using an older production release without need
<TabItem value="rolling" label="Rolling" default>
| Version | Release Date | Release Notes & Download|
|:--------|:-------------|:--------------|
| v8.2.0 | TBD | TBD |
| v9.0.0 | 2026 October 27 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v9.0.0) |
| v8.1.0 | 2026 October 5 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.1.0) |
| v8.0.1 | 2026 September 16 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.0.1) |
| v8.0.0 | 2026 September 15 | [Details · Download](https://github.com/opencloud-eu/opencloud/releases/tag/v8.0.0) |
Expand Down
Loading