summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastien D <seb.douheret@gmail.com>2017-09-12 10:20:52 +0200
committerGitHub <noreply@github.com>2017-09-12 10:20:52 +0200
commit1235b09cd15ea16acca061b47ec769d162bbb4e8 (patch)
treedeb5bd7e9ddfb329a47fc6593af02411faf1407b
parent647fd5bfa7289e9ed79f6aaca110fd0359b61af9 (diff)
Add note in README about docker user id
If you plan to use path-mapping sharing type for your projects, you need to have the same user id and group id inside and outside docker.
-rw-r--r--README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/README.md b/README.md
index 31a743d..0895e2a 100644
--- a/README.md
+++ b/README.md
@@ -76,6 +76,25 @@ This container (ID=0) exposes following ports:
- 69 : TFTP
- 2222 : ssh
+#### Manually setup docker user id
+
+If you plan to **use path-mapping sharing type for your projects**, you need to have the same user id and group id inside and outside docker. By default user and group name inside docker is set `devel` (id `1664`), use following commands to replace id `1664` with your user/group id:
+```bash
+# Set docker container name to use (usually agl-xds-xxx where xxx is USERNAME@MACHINENAME-IDX-NAME)
+seb@laptop ~$ export CONTAINER_NAME=agl-xds-seb@laptop-0-seb
+
+# First stop xds-server
+seb@laptop ~$ docker exec ${CONTAINER_NAME} bash -c ""
+
+# Change user and group id inside docker to match your ids
+seb@laptop ~$ docker exec ${CONTAINER_NAME} bash -c "usermod -u $(id -u) devel"
+seb@laptop ~$ docker exec ${CONTAINER_NAME} bash -c "groupmod -g $(id -g) devel"
+
+# Update some files ownership
+seb@laptop ~$ docker exec ${CONTAINER_NAME} bash -c "chown -R devel:devel /home/devel /tmp/xds"
+```
+
+
**`xds-server` is automatically started** as a service on container startup.
If the container is running on your localhost, you can access the web interface (what we call the "Dashboard"):