Skip to content

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

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

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

Conversation

@mgfernan
Copy link
Copy Markdown

@mgfernan mgfernan commented Aug 6, 2025

No description provided.

Copy link
Copy Markdown
Contributor

@jbangelo jbangelo left a comment

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.

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!

Copy link
Copy Markdown

@IsakTjernberg IsakTjernberg left a comment

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

**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!

- **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