Skip to content

Scripts for starting a jupter notebook in a container on a remote docker host

License

Notifications You must be signed in to change notification settings

minireference/jupytainer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jupytainer

Scripts for starting a jupyter notebook in a container on a remote docker host.

Install

Checkout this repo repo, go into it, then run

virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

Server setup

In order to run the commands, you need to setup a remote docker host, which is a linux server (Debian or Ubuntu) in the cloud with the following characteristics:

  • Has docker installed and running (you can run fab install_docker to do this)
  • Has a user allowed to run docker commands (ensure user is in the docker group)
  • Has ports TCP 8888-8900 open (this is where notebooks will run)

Put the relevant info in credentials/prod.env following the example env.

Usage

To start a new coding environment (Jupyter notebook) for user "juslie" run:

fab prod jupytainer:"julie"

This will start the Jupyter container, run the initialization steps and print the URL to share with the user (in this case Julie) so she can can access the environment and participate in the event without needing a google account.

The environment and files within it will persist as long as the container is running.

After the event, you can stop and remove the container using

fab prod dstop:"jupytainer_julie"
fab prod drm:"jupytainer_julie"

About

Scripts for starting a jupter notebook in a container on a remote docker host

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages