Skip to content
13 changes: 13 additions & 0 deletions docs/using/recipes.md
Original file line number Diff line number Diff line change
Expand Up @@ -520,3 +520,16 @@ they may be explained in the "Installation instructions" section of the Download
```{literalinclude} recipe_code/oracledb.dockerfile
:language: docker
```

## Running Jupyter Docker Stacks with Singularity

You can also start Jupyter Docker Stacks containers using **Singularity** instead of Docker. For example:

```bash
singularity run --bind "${PWD}:/home/${USER}/work" --containall docker://quay.io/jupyter/datascience-notebook:2025-03-14
```

- `--bind "${PWD}:/home/${USER}/work` binds your current directory into the container at `/home/$USER/work`. Here, $USER is your username.
- `--containall` runs the container in a fully isolated environment, ignoring most of the host’s environment and filesystem except explicitly bound paths, ensuring that Python libraries in the user’s home directory do not interfere with the container’s libraries.
- Replace `quay.io/jupyter/datascience-notebook:2025-03-14` with the desired stack and tag.
- Once running, you can access your notebooks just as you would in Docker.
Loading