diff --git a/docs/reference/run.md b/docs/reference/run.md index 70905ed7de67..99f03bb29b5d 100644 --- a/docs/reference/run.md +++ b/docs/reference/run.md @@ -1232,7 +1232,13 @@ The followings examples are all valid: ### Working directory The default working directory for running binaries within a container is the -root directory (`/`). It is possible to set a different working directory with the -Dockerfile `WORKDIR` command. The operator can override this with: +root directory (`/`). The default working directory of an image is set using +the Dockerfile `WORKDIR` command. You can override the default working +directory for an image using the `-w` (or `--workdir`) flag for the `docker +run` command: - -w="", --workdir="": Working directory inside the container +```text +$ docker run -w /home/$USER -it alpine +``` + +If the directory doesn't already exist in the container, it will be created.