What is this repository for?

A JupyterLab server designed to be deployed with Docker Compose as fast and easy as possible. Jupyter's real time collaboration feature is enabled by default, so that multiple users can collaborate and edit at the same time.

How we run this

# Running this on your personal computer puts your computer
# at risk. We run this on a virtual private server -- e.g. DigitalOcean.
ssh test@127.123.456.789  # Replace with your own username and IP address
git clone https://github.com/Augie-Environmental-Studies/jupyter-server.git
cd jupyter-server
docker compose up -d

For better security, we never expose our server to the internet directly. Instead, we use Cloudflare Tunnel to proxy every traffic and also to handle user authentication. We followed the installation guide at https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/tunnel-guide/

After installation, we configure server settings at https://one.dash.cloudflare.com/ Access - Applications menu for user authentication configs and Access - Tunnels menu for domain-name routing configs.

We login to the server with our school email. Cloudflare Tunnel checks the domain name of the email address and rejects if it's not one of our school's .edu domain names, which we preconfigured at https://one.dash.cloudflare.com/ Access - Applications menu.

How can I develop or debug using this image?
Check out the documentation of the base image at https://hub.docker.com/r/jupyter/datascience-notebook