diff --git a/docs/reference/run.md b/docs/reference/run.md index ebe5e4134093..89df5df6a1e9 100644 --- a/docs/reference/run.md +++ b/docs/reference/run.md @@ -1231,7 +1231,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.