Upgrade
This guide provides steps to upgrade OpenCloud for both docker and docker compose
1. Stop OpenCloud​
Stop the currently running OpenCloud instance:
- docker
- docker compose
docker stop opencloud
docker compose stop
2. Backup Config and Data​
It is recommended to create a backup before proceeding with the upgrade.
TODO: put backup link #103.
3. Pull the new Opencloud version​
docker pull opencloudeu/opencloud:{tag}
4. 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.
5. 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
6. Conclusion​
Make sure that all previously created data, users, shared files, public links exist.