hazza/docker-stacks
1
0
Fork 0
mirror of https://github.com/jupyter/docker-stacks.git synced 2025-10-14 05:22:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

📝 Improvements to troubleshoot

Browse Source
This commit is contained in:
Tania Allard
2022-02-02 13:03:39 +00:00
parent e4be6856ef
commit 66566d9bd0
1 changed files with 7 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/using/troubleshooting.md
View File

@@ -117,6 +117,8 @@ In this case the user of the container (`jovyan`) and the owner of the mounted v
uid=1234(jovyan) gid=1234(jovyan) groups=1234(jovyan),100(users) uid=1234(jovyan) gid=1234(jovyan) groups=1234(jovyan),100(users)
``` ```
- If you pass a numeric UID, it must be in the range of 0-2147483647
If you need to specify a different user check the following section in this page. If you need to specify a different user check the following section in this page.
## Permission issues after changing the UID/GIU and USER in the container ## Permission issues after changing the UID/GIU and USER in the container
@@ -188,7 +190,7 @@ If on top of changing the UID and GID you also **need to create a new user**, yo
- `"$(id -u)" and "$(id -g)"` will dynamically assign the `UID` and `GID` of the new user (`callisto`) to that of the local user executing the run command - `"$(id -u)" and "$(id -g)"` will dynamically assign the `UID` and `GID` of the new user (`callisto`) to that of the local user executing the run command
**Additional tips and troubleshooting commands:** ## Additional tips and troubleshooting commands
- Use absolute paths when using the `-v` flag: - Use absolute paths when using the `-v` flag:
@@ -196,7 +198,8 @@ If on top of changing the UID and GID you also **need to create a new user**, yo
-v $(PWD)/<my-vol>:/home/jovyan/work -v $(PWD)/<my-vol>:/home/jovyan/work
``` ```
In this example, we use the syntax `$(PWD)`, which is replaced with the full path to the current directory. The destination path should also be an absolute path starting with a `/` such as `home/jovyan/work`. In this example, we use the syntax `$(PWD)`, which is replaced with the full path to the current directory. The destination
path should also be an absolute path starting with a `/` such as `home/jovyan/work`.
- You might want to consider using the Docker native `--user <UID>` and `--group-add users` flags instead of `-e NB_GID` and `-e NB_UID`: - You might want to consider using the Docker native `--user <UID>` and `--group-add users` flags instead of `-e NB_GID` and `-e NB_UID`:
@@ -215,7 +218,8 @@ If on top of changing the UID and GID you also **need to create a new user**, yo
- Use `docker inspect <container_id>` and look for the [`Mounts` section](https://docs.docker.com/storage/volumes/#start-a-container-with-a-volume) to verify that the volume was created and mounted accordingly: - Use `docker inspect <container_id>` and look for the [`Mounts` section](https://docs.docker.com/storage/volumes/#start-a-container-with-a-volume) to verify that the volume was created and mounted accordingly:
```json ```json
# for example, for a my-vol volume created with docker volume create <my-vol> # for example, for a my-vol volume created with
# docker volume create --name <my-vol>
"Mounts": [ "Mounts": [
{ {