https://github.com/codelibs/jupyterhub-docker
JupyterHub on Docker
https://github.com/codelibs/jupyterhub-docker
Last synced: over 1 year ago
JSON representation
JupyterHub on Docker
- Host: GitHub
- URL: https://github.com/codelibs/jupyterhub-docker
- Owner: codelibs
- License: apache-2.0
- Created: 2017-03-26T13:14:43.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2019-07-06T12:38:41.000Z (almost 7 years ago)
- Last Synced: 2025-01-28T10:36:19.765Z (over 1 year ago)
- Language: Dockerfile
- Homepage:
- Size: 37.1 KB
- Stars: 4
- Watchers: 3
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# JupyterHub Docker
## Overview
JupyterHub Docker is a Docker image for JupyterHub.
A default authentication for JupyterHub Docker uses GitHub's OAuth.
## Build Docker Images
### Ubuntu 16.04 based Image
```
./bin/jupyter-docker build -t ubuntu18.04
```
### Machine Learning Image
```
./bin/jupyter-docker build -t machinelearning
```
### CUDA based Image
```
./bin/jupyter-docker build -t cuda10.0-cudnn7
```
### CUDA based Machine Learning Image
```
./bin/jupyter-docker build -t cuda-machinelearning
```
## Setup
### OAuth (GitHub)
Create a configuration file:
```
cp env/localhost env/`uname -n`
cat env/`uname -n`
CONTEXT_PATH=/
GITHUB_CLIENT_ID=<>
GITHUB_CLIENT_SECRET=<>
OAUTH_CALLBACK_URL=http://localhost:8000/hub/oauth_callback
```
For GITHUB\_CLIENT\_ID and GITHUB\_CLIENT\_SECRET, see [Building OAuth Apps](https://developer.github.com/apps/building-oauth-apps/).
### Login Users
JupyterHub Docker uses acceptable users list, `res/userlist`.
You need to update userlist file.
The format is ` `.
userid is an user id in Docker container, username is GitHub account, and mode is admin or (empty).
For details, see `res/addusers.sh`.
## Operations
### Run Docker Container
```
./bin/jupyter-docker run -t
```
Tag names are as below:
- ubuntu16.04
- cuda10.0-cudnn7
- cuda-machinelearning
URL for this Jupyterhub is `http://localhost:8000/`.
### Stop Docker Container
```
./bin/jupyter-docker stop -t
```