Merge pull request #42 from poplav/minimal_kernel

New docker stack for a headless kernel

minimal-kernel/Dockerfile

+# Copyright (c) Jupyter Development Team.
+FROM debian:jessie
+
+MAINTAINER Jupyter Project <jupyter@googlegroups.com>
+
+USER root
+
+# Install all OS dependencies for fully functional notebook server
+ENV DEBIAN_FRONTEND noninteractive
+RUN apt-get update && apt-get install -yq --no-install-recommends \
+    wget \
+    python3-dev \
+    build-essential \
+    python3-pip \
+    python3-zmq \
+    && apt-get clean
+
+# Install Tini
+RUN wget --quiet https://github.com/krallin/tini/releases/download/v0.6.0/tini && \
+    echo "d5ed732199c36a1189320e6c4859f0169e950692f451c03e7854243b95f4234b *tini" | sha256sum -c - && \
+    mv tini /usr/local/bin/tini && \
+    chmod +x /usr/local/bin/tini
+
+# Configure environment
+ENV SHELL /bin/bash
+ENV KG_USER jovyan
+ENV KG_UID 1000
+
+# Create jovyan user with UID=1000
+RUN useradd -m -s /bin/bash -N -u $KG_UID $KG_USER
+
+# Install Kernel Gateway
+RUN pip3 install jupyter_kernel_gateway==0.2.0
+
+# Configure container startup
+USER nobody
+EXPOSE 8888
+WORKDIR /tmp
+ENTRYPOINT ["tini", "--", "jupyter", "kernelgateway"]
+CMD ["--KernelGatewayApp.ip=0.0.0.0"]
+
+# Run container as jovyan
+USER jovyan
\ No newline at end of file

minimal-kernel/README.md

+# Kernel Gateway Stack
+
+## What it Gives You
+* [Jupyter Kernel Gateway](https://github.com/jupyter-incubator/kernel_gateway) that enables programmatic access to kernels
+* No preinstalled scientific computing packages
+* [tini](https://github.com/krallin/tini) as the container entrypoint
+
+## Basic Use
+
+The following command starts a container with the Kernel Gateway server listening for HTTP connections on port 8888.
+
+```
+docker run -d -p 8888:8888 jupyter/minimal-kernel
+```
+
+## Docker Options and More Information
+* For more information on the Kernel Gateway and its configuration options see the
+[Kernel Gateway Repository](https://github.com/jupyter-incubator/kernel_gateway#what-it-gives-you).
\ No newline at end of file