Skip to content

Revise upgrade instructions for OpenCloud #900

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
Jun 2, 2026
Merged

Revise upgrade instructions for OpenCloud #900

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
15 changes: 8 additions & 7 deletions docs/admin/maintenance/upgrade/upgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,19 +37,19 @@ It is recommended to create a [backup](../backup) before proceeding with the upg

## Pull the latest OpenCloud Compose

If you are using Docker Compose with the `opencloud-compose` repository, update your local checkout before pulling the new container image:
If you are using Docker Compose with the `opencloud-compose` repository, update your local checkout before pulling the new container image.

Skip this step if you run OpenCloud with plain Docker (`docker run`):

```bash
cd /opencloud-compose
git pull
```

Skip this step if you run OpenCloud with plain Docker (`docker run`).

## Pull the new Opencloud version

```bash
docker pull opencloudeu/opencloud:{tag}
docker pull opencloudeu/opencloud-rolling:{tag} # or opencloudeu/opencloud:{tag} depending on the version you're using
```

## Verify Configuration Changes
Expand All @@ -59,7 +59,8 @@ If upgrading from an older release, check for required configuration changes:
Go inside the container:

```bash
docker run --rm -it --entrypoint /bin/sh -v $HOME/opencloud/opencloud-config:/etc/opencloud opencloudeu/opencloud:{tag}
docker run --rm -it --entrypoint /bin/sh -v /YOUR/OC_CONFIG/PATH:/etc/opencloud opencloudeu/opencloud-rolling:{tag}
# or opencloudeu/opencloud:{tag} depending on the version you're using
```

```bash
Expand All @@ -85,12 +86,12 @@ If you see `no changes, your config is up to date`, no further action is needed.
-e OC_INSECURE=true \
-e PROXY_HTTP_ADDR=0.0.0.0:9200 \
-e OC_URL=https://localhost:9200 \
opencloudeu/opencloud:{tag}
opencloudeu/opencloud-rolling:{tag}
```
</TabItem>
<TabItem value="docker-compose" label="docker compose">
```Shell
OC_DOCKER_IMAGE=opencloudeu/opencloud OC_DOCKER_TAG=tag docker compose up -d
docker compose up -d
```
</TabItem>
</Tabs>
Expand Down