LAB-linuxserver/cstate
1
0
Fork 0
mirror of https://github.com/linuxserver/cstate.git synced 2026-02-20 07:55:25 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add information about updating Nextcloud from older versions

Browse Source 
Signed-off-by: Eric Nemchik <eric@nemchik.com>
This commit is contained in:
Eric Nemchik 2023-06-19 11:21:23 -05:00
parent b4fd98c430
commit ccd356c390
No known key found for this signature in database
1 changed files with 37 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
content/issues/2023-06-19-nextcloud.md
View File

@ -24,3 +24,40 @@ Updating Nextcloud is done by pulling the new image, and recreating the containe
It is only possible to upgrade one major version at a time. For example, if you want to upgrade from version 14 to 16, you will have to upgrade from version 14 to 15, then from 15 to 16.
Since all data is stored in the `/config` and `/data` volumes, nothing gets lost. The startup script will check for the version in your volume and the installed docker version. If it finds a mismatch, it automatically starts the upgrade process.
### Can't start Nextcloud
If after updating your container image you receive a message along these lines:
> Can't start Nextcloud because the version of the data (`#.#.#.#`) is more than one major version behind the docker image version (`#.#.#.#`) and upgrading more than one major version is not supported. Please run an image tagged for the major version `##` first."
The version of Nextcloud that you have installed in your persistent `/config` volume will need to be updated using an older image before you can use the new image.
| Image/Tag | PHP | Notes |
| - | - | - |
| `lscr.io/linuxserver/nextcloud:26.0.2-ls248` | 8.2 | Use this tag if your major version is 26 |
| `lscr.io/linuxserver/nextcloud:26.0.2-ls245` | 8.1 | Included for reference as the last tag released with PHP 8.1 |
| `lscr.io/linuxserver/nextcloud:25.0.4-ls229` | 8.1 | |
| `lscr.io/linuxserver/nextcloud:24.0.12-ls239` | 8.1 | Use this tag if your major version is 24 |
| `lscr.io/linuxserver/nextcloud:24.0.6-ls204` | 7.4 | Included for reference as the last tag released with PHP 7.4 |
| `lscr.io/linuxserver/nextcloud:23.0.4-ls184` | 7.4 | |
| `lscr.io/linuxserver/nextcloud:22.2.3-ls165` | 7.4 | |
- Check your `/config/www/nextcloud/config/config.php` file or `/config/www/nextcloud/version.php` file to determine the version you have installed
- Switch your image to the corresponding major version from the table above (ex: your files indicate `24.x.x`, use `lscr.io/linuxserver/nextcloud:24.0.12-ls239`) and start the container
- Execute `docker exec -it nextcloud updater.phar` ***repeatedly*** until there are no more updates, or the updater says `This version of Nextcloud is not compatible with > PHP x.x`
- Check your files again to determine the version you have installed
- If your installed version is below 26, repeat the steps above until you get to version 26
- If your installed version is 26 or 27, continue with the instructions below
- Switch your image to `lscr.io/linuxserver/nextcloud:27.0.0-ls250` and start the container. Note the `updater.phar` is no longer available, or needed
- Execute `docker logs nextcloud` and check for any issues (report [issues on GitHub](https://github.com/linuxserver/docker-nextcloud/issues))
- As of posting this information, Nextclouod 27 is the latest current version. If you are reading this after a new major version of Nextcloud beyond 27 is released, check [releases on GitHub](https://github.com/linuxserver/docker-nextcloud/releases) and proceed to switch to the next major version tag one by one until you are current. Updating more than one major version at a time is not supported
- You should now be able to switch your image to `lscr.io/linuxserver/nextcloud` (no tag) if you prefer to run the latest image (although we do recommend pinning a specific version)
- Execute `docker exec -it nextcloud mv /config/nginx/site-confs/default.conf /config/nginx/site-confs/default.conf.bak`
- Execute `docker exec -it nextcloud mv /config/nginx/nginx.conf /config/nginx/nginx.conf.bak`
- Nextcloud should now be in a working state
Optional:
- If you had customized any of the nginx configs that were renamed above, compare the `.bak` file to the new live file and apply any customizations you require. Note the `root` line in `site-confs/default.conf` should be changed from `/config/www/nextcloud/` to `/app/www/public`
- Remove the `.bak` files