Java API client for Docker

Supports a subset of the Docker Client API v1.14, Docker Server version 1.2.0

The current implementation is based on Jersey 2.x and therefore classpath incompatible with older Jersey 1.x dependent libraries!

Developer forum for docker-java

• Java 1.6+
• Maven 3.0.5
• Docker daemon running

Some of the tests are using a localhost instance of Docker and require manual setup. In order to enable an easy standard build, these integration tests are disabled by default.

To run the full set of tests, make sure you have a local Docker daemon running and hten provide your https://registry.hub.docker.com/account/login/ information via system properties:

$ mvn clean install -DskipITs=false -Ddocker.io.username=... -Ddocker.io.password=... -Ddocker.io.email=...

If you are using a remote Docker server, add its URL like this: -Ddocker.io.url=http://...:2375.

By default Docker server is using UNIX sockets for communication with the Docker client, however docker-java client uses TCP/IP to connect to the Docker server, so you will need to make sure that your Docker server is listening on TCP port. To allow Docker server to use TCP add the following line to /etc/default/docker

DOCKER_OPTS="-H tcp://127.0.0.1:2375 -H unix:///var/run/docker.sock"

More details setting up Docker server can be found in official documentation: http://docs.docker.io/en/latest/use/basics/

Now make sure that docker is up:

$ docker -H tcp://127.0.0.1:2375 version

Client version: 0.8.0
Go version (client): go1.2
Git commit (client): cc3a8c8
Server version: 1.2.0
Git commit (server): fa7b24f
Go version (server): go1.3.1

Run build with tests:

$ mvn clean install -DskipTests=false

<dependency>
      <groupId>com.github.docker-java</groupId>
      <artifactId>docker-java</artifactId>
      <version>0.10.1</version>
</dependency>

<dependency>
      <groupId>com.github.docker-java</groupId>
      <artifactId>docker-java</artifactId>
      <version>0.10.2-SNAPSHOT</version>
</dependency>

Latest SNAPSHOT is published to maven repo: https://oss.sonatype.org/content/groups/public via

For code examples, please look at the Wiki or Test cases

There are a couple of configuration items, all of which have sensible defaults:

• url The Docker URL, e.g. http://localhost:2375.
• version The API version, e.g. 1.14.
• username Your repository username (required to push containers).
• password Your repository password.
• email Your repository email.

There are three ways to configure, in descending order of precedence:

In your application, e.g.

DockerClientConfigBuilder configBuilder = DockerClientConfig.createDefaultConfigBuilder();
configBuilder.withVersion("1.14");
configBuilder.withUri("http://my-docker-host.tld:2375");
configBuilder.withUsername("dockeruser");
configBuilder.withPassword("ilovedocker");
configBuilder.withEmail("dockeruser@github.com");
DockerClientConfig config = configBuilder.build();
DockerClient docker = DockerClientBuilder.getInstance(config).build();

E.g.

java -Ddocker.io.username=kpelykh pkg.Main

In $HOME/.docker.io.properties, e.g.:

docker.io.username=dockeruser

In the class path at /docker.io.properties, e.g.:

docker.io.url=http://localhost:2375
docker.io.version=1.13