Skip to content

High performance self-hosted photo and video management solution.

docs: add developer notes about rootless docker setup (#13250)

Rudolf Horváth689c6aa2762f
diff --git a/docker/docker-compose.dev.yml b/docker/docker-compose.dev.yml
index 7f4806a99d..0b14ea7d6a 100644
--- a/docker/docker-compose.dev.yml
+++ b/docker/docker-compose.dev.yml
@@ -57,6 +57,8 @@ services:
immich-web:
container_name: immich_web
image: immich-web-dev:latest
+ # Needed for rootless docker setup, see https://github.com/moby/moby/issues/45919
+ # user: 0:0
build:
context: ../web
command: ['/usr/src/app/bin/immich-web']
diff --git a/docs/docs/developer/setup.md b/docs/docs/developer/setup.md
index 92f0ce0c28..9dbaf157b5 100644
--- a/docs/docs/developer/setup.md
+++ b/docs/docs/developer/setup.md
@@ -45,7 +45,10 @@ All the services will be started with hot-reloading enabled for a quick feedback
You can access the web from `http://your-machine-ip:3000` or `http://localhost:3000` and access the server from the mobile app at `http://your-machine-ip:3000/api`
-**Note:** the "web" development container runs with uid 1000. If that uid does not have read/write permissions on the mounted volumes, you may encounter errors
+**Notes:**
+
+- The "web" development container runs with uid 1000. If that uid does not have read/write permissions on the mounted volumes, you may encounter errors
+- In case of rootless docker setup, you need to use root within the container, otherwise you will encounter read/write permission related errors, see comments in `docker/docker-compose.dev.yml`.
#### Connect web to a remote backend