Installing repo2docker (original) (raw)

repo2docker requires Python 3.6 or above on Linux and macOS. Seebelow for more information about Windows support.

Prerequisite: Docker#

Install Docker as it is required to build Docker images. TheCommunity Edition, is available for free.

Recent versions of Docker are recommended. The latest version of Docker, 18.03, successfully builds repositories frombinder-examples. The BinderHub helm chart uses version17.11.0-ce-dind. See thehelm chartfor more details.

Optional: Mercurial#

For Mercurial repositories, Mercurial andhg-evolve need to be installed. For example, on Debian based distributions, one can do:

sudo apt install mercurial $(hg debuginstall --template "{pythonexe}") -m pip install hg-evolve --user

To install Mercurial on other systems, see here.

Note that for old Mercurial versions, you may need to specify a version for hg-evolve. For example, hg-evolve==9.2 for hg 4.5 (which is installed withapt on Ubuntu 18.4).

Installing with 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/jupyterhub/repo2docker/archive/main.zip

For information on using repo2docker, see Using repo2docker.

Installing from source code#

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/jupyterhub/repo2docker.git cd repo2docker python3 -m pip install -e .

That’s it! For information on using repo2docker, seeUsing repo2docker.

Windows support#

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.