Docker

atoti distributes an official image on DockerHub. It contains the atoti library and its JupyterLab extension ready to use.

Usage

Pull the image:

docker pull atoti/atoti

Create a volume where the data (notebooks, files..) can be persisted when the Docker container is stopped:

docker volume create atoti-volume

Run the Docker image using the created volume:

docker run --publish 8888:8888 --volume atoti-volume:/home/jovyan/work atoti/atoti

Jupyter will print the URL of the application with a security token, such as http://localhost:8888?token=XXXXX. On a distant machine, use http://<DOCKER-MACHINE-IP>:8888?token=XXXXX.

Advanced

Expose on another port

The application can be served on another port than 8888 by changing the port in the publish mapping (--publish XXXX:8888) and setting the PORT environment variable to the port value.

docker run --publish 9999:8888 --volume atoti-volume:/home/jovyan/work --env PORT=9999 atoti/atoti

Build custom image

It is also possible to build custom Docker images with atoti. The Dockerfile used to build the official image is a good starting point.