From c83d457857a3eddea4ab5ecdd25d1787237516ec Mon Sep 17 00:00:00 2001 From: Alexandra Branco Date: Mon, 7 Oct 2024 18:27:24 +0100 Subject: [PATCH] Added information about permissions errors (migrating to alpine) (#2289) * Added information about permissions errors when migrating docker images to alpine. * Updated README.md documentation after review. --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index e434f0a8..b2ec983d 100644 --- a/README.md +++ b/README.md @@ -620,6 +620,16 @@ You're already using Nextcloud and want to switch to docker? Great! Here are som docker compose exec app chown -R www-data:www-data /var/www/html/custom_apps ``` +## Migrating from a non-Alpine image to an Alpine image + +If you already use one of our non-Alpine images, but want to switch to an Alpine-based image, you may experience permissions problems with your existing volumes. This is because the Alpine images uses a different user ID for `www-data`. +So, you must change the ownership of the `/var/www/html` (or `$NEXTCLOUD_DATA_DIR`) folder to be compatible with Alpine: + +```console +docker exec container-name chown -R www-data:root /var/www/html +``` + +After changing the permissions, restart the container and the permission errors should disappear. # Help (Questions / Issues) **If you have any questions or problems while using the image, please ask for assistance on the Help Forum first (https://help.nextcloud.com)**.