Supported Docker versions

Miquel Sabaté Solà edited this page Sep 30, 2016 · 3 revisions

Docker technologies have a fast iteration pace. This is a good thing, but it comes with some challenges. As requested by some of our users, the following table shows which versions of Docker and Docker Distribution are supported by each Portus version:

Portus Docker Engine Docker Distribution
master 1.6+ 2.0+ (2.4+ recommended)
2.1.0 1.6+ 2.0+ (2.4+ recommended)
2.0.0 & 2.0.1 1.6 to 1.9 2.0 to 2.2
2.0.2 1.6 to 1.9 2.0 to 2.4
2.0.3+ 1.6+ 2.0 to 2.4

Let's detail some of the version being specified:

  • Docker Engine 1.6 is the first version supported by Docker Distribution 2. Therefore, this requirement is also the same for Portus.
  • As of Docker 1.10, the Manifest Version 2, Schema 2 is the one being used. This is only supported by Portus in the master branch and in 2.0.3.
  • Docker Distribution 2.3 supports both Manifest versions, but some changes had to be made in order to offer backwards compatibility. This is not supported neither for Portus 2.0.0 nor 2.0.1. Moreover, Docker Distribution 2.4 was the first to introduce garbage collection. Because of this we recommend running at least 2.4 if you are using 2.1 (or higher), or master so you can remove images and tags.