Upgrade
This guide provides steps to upgrade OpenCloud for both docker and docker compose
Stop OpenCloud
Stop the currently running OpenCloud instance:
- docker
- docker compose
docker stop opencloud
docker compose stop
Backup Config and Data
It is recommended to create a backup before proceeding with the upgrade.
Pull the new Opencloud version
docker pull opencloudeu/opencloud:{tag}
Verify Configuration Changes
If upgrading from an older release, check for required configuration changes:
Go inside the container:
docker run --rm -it --entrypoint /bin/sh -v $HOME/opencloud/opencloud-config:/etc/opencloud opencloudeu/opencloud:{tag}
opencloud init --diff
If you see no changes, your config is up to date
, no further action is needed. Otherwise, update your opencloud.yaml
file accordingly and start OpenCloud.

Start OpenCloud with updated image
- docker
- docker compose
docker run \
--name opencloud \
--rm \
-it \
-p 9200:9200 \
-v $HOME/opencloud/opencloud-config:/etc/opencloud \
-v $HOME/opencloud/opencloud-data:/var/lib/opencloud \
-e OC_INSECURE=true \
-e PROXY_HTTP_ADDR=0.0.0.0:9200 \
-e OC_URL=https://localhost:9200 \
opencloudeu/opencloud:{tag}
OC_DOCKER_IMAGE=opencloudeu/opencloud OC_DOCKER_TAG=tag docker compose up -d
Conclusion
Make sure that all previously created data, users, shared files, public links exist.