diff --git a/docs/using/troubleshooting.md b/docs/using/troubleshooting.md index b8c554b9..52aecdf3 100644 --- a/docs/using/troubleshooting.md +++ b/docs/using/troubleshooting.md @@ -310,3 +310,19 @@ If you are a regular user of VSCode and the Jupyter extension, you might experie You can achieve this from the `Preferences > Jupyter` menu in VScode: ![VSCode Preferences UI - Jupyter: Disable Jupyter Auto Start checkbox unchecked](../_static/using/troubleshooting/vscode-jupyter-settings.png) + +3. **Route container to unused local port** + + Instead of mapping Docker port `8888` to local port `8888`, map to another unused local port. + You can see an example of mapping to local port `8001`: + + ```bash + docker run -it --rm -p 8001:8888 jupyter/datascience-notebook + ``` + + When the terminal provides the link to access Jupyter: , + change the default port value of `8888` in the url to the port value mapped with the `docker run` command. + + In this example we use 8001, so the edited link would be: . + + Note: Port mapping for Jupyter has other applications outside of Docker. For example, it can be used to allow multiple Jupyter instances when using SSH to control cloud devices.