32 lines
1.1 KiB
Markdown
32 lines
1.1 KiB
Markdown
# Custom Jupyter Notebook Server Image
|
|
|
|
This is an example of using a custom Jupyter Notebook server Docker image with JupyterHub. The `Dockerfile` builds from the `jupyter/scipy-notebook` image, but customizes the image in the following ways:
|
|
|
|
* installs an additional Python package to make it available to notebooks
|
|
* uses a custom entrypoint script that copies sample notebooks to the user's notebook directory before executing the run command that was provided to the container
|
|
|
|
## Build the Image
|
|
|
|
Build and tag the image using the `Dockerfile` in this directory.
|
|
|
|
```
|
|
docker build -t my-custom-notebook .
|
|
```
|
|
|
|
## Run JupyterHub Container
|
|
|
|
To have JupyterHub spawn the `my-custom-notebook` image for single-user Notebook
|
|
servers, set the `DOCKER_NOTEBOOK_IMAGE` environment variable to the image name
|
|
when you run the JupyterHub container. For example, run the following
|
|
**from the root directory** of this repository:
|
|
|
|
```
|
|
export DOCKER_NOTEBOOK_IMAGE=my-custom-notebook
|
|
|
|
# bring down the JupyterHub container, if running
|
|
./hub.sh down
|
|
|
|
# bring it back up
|
|
./hub.sh up -d
|
|
```
|