beevor / gbdx-notebook

A GBDX notebook server in Docker.

gbdx-notebook

A GBDX notebook server in Docker. Is is based on the Jupyter Notebook Scientific Python Stack and also includes packages for local prototyping with geospatial raster data and launching workflows on GBDX (gdal, rasterio, protogen, gdbxtools).

The server can be run locally or as part of a Jupyter hub.

Local installation

Install Docker and start the docker engine (this step is OS dependent).

Clone this repository:

git clone https://github.com/platformstories/gbdx-notebook

Then:

cd gbdx-notebook
docker build -t gbdx-notebook .

For access to the protogen repo contact [e-mail]; fill in your github username and password next to ENV PROTOUSER and ENV PROTOPASSWORD, respectively. If you don't have access to the repo, comment out the corresponding lines in the Dockerfile.

Run the notebook server

To run the notebook server with root privileges:

docker run -it -p 8888:8888 -e GRANT_SUDO=yes --user root gbdx-notebook

You can find more options here.

The Jupyter dashboard is accessible via your browser at localhost:8888.

You can stop the server with Ctrl-C. If you want to restart a particular container which, e.g., contains work that you have saved:

docker start <container-id>
docker attach <container-id>