diff --git a/Dockerfile b/Dockerfile index 0d9fb6f..0550477 100644 --- a/Dockerfile +++ b/Dockerfile @@ -16,7 +16,7 @@ ####################################################################################################### # Base image from JupyterLab ####################################################################################################### -ARG BASE_IMAGE=jupyter/base-notebook +ARG BASE_IMAGE=quay.io/jupyter/base-notebook ARG BASE_TAG=latest FROM ${BASE_IMAGE}:${BASE_TAG} diff --git a/README.md b/README.md index 7c7ea00..cfbb35b 100644 --- a/README.md +++ b/README.md @@ -84,7 +84,7 @@ There is also that one can interact with (make a copy first) — if the link doesn't work (Google Drive sharing publicly is odd), [download it from GitHub](examples/google_colab_demo.ipynb) and upload it to Google's Colab. -Finally, because it's compiled and not intepreted, it has a slightly different "semantic" than the Python kernels. +Finally, because it's compiled and not interpreted, it has a slightly different "semantic" than the Python kernels. It's highly recommended quickly browsing through the [**tutorial**](examples/tutorial.ipynb). ## Installation diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index b32be5e..2cd598a 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -7,6 +7,7 @@ * Added sudo for apt install and apt update. * Added support for `autostart.sh` that if present in the mounted container `/notebooks` directory, and if root owned and set as executable. +* Updated Dockerfile to latest version to JupyterLab -- now the base docker is served `quay.io/jupyter/base-notebook` ## v0.10.5, Added SendAsDownload diff --git a/docs/docker.md b/docs/docker.md index 9edd0d3..18f9f46 100644 --- a/docs/docker.md +++ b/docs/docker.md @@ -1,8 +1,16 @@ # Docker Customization -If the container you run `gonb` needs some custom initialization, and you don't want to simply edit the dockerfile and -create your own docker, just create the file `autostart.sh` in the directory mounted under `/notebooks` in the container, -owned by `root` and with executable permissions, and it will be executed at start up of the container by default. +1. The docker runs _JupyterLab_ and _GoNB_ under the user `$NB_USER` (== "jovyan"). +2. It has configured `sudo` privileges for `apt update` and `apt install *`. So a cell with + `!sudo apt install ` will work, and install your package. +3. One can always create another docker based on `janpfeifer/gonb_jupyterlab@latest` +4. Create an `autostart.sh` script, see next section. + +## Customization with `autostart.sh` + +If you create the file `autostart.sh` in the directory mounted under `/notebooks` in the container, +**owned by `root` and with executable permissions**, it will be executed at start up of the container by default +**as `root`**. This allows you to download/install databases, or set up credentials, etc.