Add info about root_dir in docs (#1971)

* Add info about root_dir in docs

* Add note to running.md as well

* Better wording
This commit is contained in:
Ayaz Salikhov
2023-08-18 19:16:49 +02:00
committed by GitHub
parent 284be27ee7
commit cf2791494e
2 changed files with 14 additions and 0 deletions

View File

@@ -61,6 +61,13 @@ Due to the usage of [the flag `--rm`](https://docs.docker.com/engine/reference/r
system when the container exits, but any changes made to the `~/work` directory and its files in the container will remain intact on the host. system when the container exits, but any changes made to the `~/work` directory and its files in the container will remain intact on the host.
[The `-it` flag](https://docs.docker.com/engine/reference/commandline/run/#name) allocates pseudo-TTY. [The `-it` flag](https://docs.docker.com/engine/reference/commandline/run/#name) allocates pseudo-TTY.
```{note}
By default, [jupyter's root_dir](https://jupyter-server.readthedocs.io/en/latest/other/full-config.html) is `/home/jovyan`.
So, new notebooks will be saved there, unless you change the directory in the file browser.
To change the default directory, you will need to specify `ServerApp.root_dir` by adding this line to previous command: `start-notebook.sh --ServerApp.root_dir=/home/jovyan/work`.
```
## Contributing ## Contributing
Please see the [Contributor Guide on ReadTheDocs](https://jupyter-docker-stacks.readthedocs.io/en/latest/) Please see the [Contributor Guide on ReadTheDocs](https://jupyter-docker-stacks.readthedocs.io/en/latest/)

View File

@@ -65,6 +65,13 @@ Pressing `Ctrl-C` twice shuts down the Server and immediately destroys the Docke
New files and changes in `~/work` in the container will be preserved. New files and changes in `~/work` in the container will be preserved.
Any other changes made in the container will be lost. Any other changes made in the container will be lost.
```{note}
By default, [jupyter's root_dir](https://jupyter-server.readthedocs.io/en/latest/other/full-config.html) is `/home/jovyan`.
So, new notebooks will be saved there, unless you change the directory in the file browser.
To change the default directory, you will need to specify `ServerApp.root_dir` by adding this line to previous command: `start-notebook.sh --ServerApp.root_dir=/home/jovyan/work`.
```
**Example 3:** **Example 3:**
This command pulls the `jupyter/all-spark-notebook` image currently tagged `latest` from Docker Hub if an image tagged `latest` is not already present on the local host. This command pulls the `jupyter/all-spark-notebook` image currently tagged `latest` from Docker Hub if an image tagged `latest` is not already present on the local host.