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.