Skip to content

Add guide to run tutorials using a Jupyter Docker image - #518

Open
mgfernan wants to merge 2 commits into
swift-nav:masterfrom
mgfernan:tutorials_with_docker
Open

Add guide to run tutorials using a Jupyter Docker image#518
mgfernan wants to merge 2 commits into
swift-nav:masterfrom
mgfernan:tutorials_with_docker

Conversation

@mgfernan

@mgfernan mgfernan commented Aug 6, 2025

Copy link
Copy Markdown

No description provided.

@jbangelo jbangelo left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good! Thanks for expanding on the documentation! I think we could simplify a couple of the steps with a Dockerfile and maybe even using Docker compose. What do others think about that? Too much overhead? I'd be happy to do the dirty work, either in this PR or in a follow up.

Comment thread tutorials/README.md Outdated
3. **Launch the Docker container**

```sh
docker run -ti -p 8888:8888 -v `pwd`:/home/jovyan jupyter/datascience-notebook:latest

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added in a new commit of this PR. Thanks!

@IsakTjernberg IsakTjernberg left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Just two small comments

Comment thread tutorials/README.md Outdated
**Command breakdown:**
- `-ti`: Run in interactive mode with a TTY
- `-p 8888:8888`: Map port 8888 from container to host
- `-v \`pwd\`/albatross:/home/jovyan`: Mount the albatross directory into the container

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: the /albatross part here I think should be removed?
Also a question, is the jovyan the name of the users home directory in the Docker datascience-notebook?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done, thanks!

Comment thread tutorials/README.md Outdated
- **Port 8888 already in use**: If you get a port binding error, either stop the existing service using port 8888 or use a different port:

```sh
docker run -ti -p 8889:8888 -v `pwd`/albatross:/home/jovyan jupyter/datascience-notebook:latest

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: Also remove /albatross from here

Hopefully clarifies questions posted by @jbangelo and @IsakTjernberg (thanks!)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants