repo2docker
repo2docker requires Python 3.5 and above on Linux and macOS. See below for more information about Windows support.
Install Docker as it is required to build Docker images. The Community Edition, is available for free.
Recent versions of Docker are recommended. The latest version of Docker, 18.03, successfully builds repositories from binder-examples. The BinderHub helm chart uses version 17.11.0-ce-dind. See the helm chart for more details.
18.03
17.11.0-ce-dind
pip
We recommend installing repo2docker with the pip tool:
python3 -m pip install jupyter-repo2docker
for the latest release. To install the most recent code from the upstream repository, run:
python3 -m pip install https://github.com/jupyter/repo2docker/archive/master.zip
For information on using repo2docker, see Using repo2docker.
Alternatively, you can install repo2docker from a local source tree, e.g. in case you are contributing back to this project:
git clone https://github.com/jupyter/repo2docker.git cd repo2docker python3 -m pip install -e .
That’s it! For information on using repo2docker, see Using repo2docker.
Windows support for repo2docker is still in the experimental stage.
An article about using Windows and the WSL (Windows Subsytem for Linux or Bash on Windows) provides additional information about Windows and docker.