Skip to content

Commit 689c6aa

Browse files
authored
docs: add developer notes about rootless docker setup (immich-app#13250)
1 parent 6ec94f9 commit 689c6aa

File tree

2 files changed

+6
-1
lines changed

2 files changed

+6
-1
lines changed

docker/docker-compose.dev.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,8 @@ services:
5757
immich-web:
5858
container_name: immich_web
5959
image: immich-web-dev:latest
60+
# Needed for rootless docker setup, see https://github.com/moby/moby/issues/45919
61+
# user: 0:0
6062
build:
6163
context: ../web
6264
command: ['/usr/src/app/bin/immich-web']

docs/docs/developer/setup.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,10 @@ All the services will be started with hot-reloading enabled for a quick feedback
4545

4646
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`
4747

48-
**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
48+
**Notes:**
49+
50+
- 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
51+
- 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`.
4952

5053
#### Connect web to a remote backend
5154

0 commit comments

Comments
 (0)