Binding a port to a host interface using the REST API

Question

The documentation for the commandline interface says the following:

To bind a port of the container to a specific interface of the host system, use the

Answer 1

Starting containers with PortBindings in the HostConfig was deprecated in v1.10 and removed in v1.12.

Both these configuration parameters should now be included when creating the container.

POST /containers/create

{
    "Image": image_id,
    "ExposedPorts": {
        "22/tcp": {}
    },
    "HostConfig": {
        "PortBindings": { "22/tcp": [{ "HostPort": "" }] }
    }
}

Answer 2

This is an undocumented feature. I found my answer on the mailing list:

When creating the container you have to set ExposedPorts:

"ExposedPorts": { "22/tcp": {} }

When starting your container you need to set PortBindings:

"PortBindings": { "22/tcp": [{ "HostPort": "11022" }] }

There already is an issue on github about this.

Answer 3

I know this question had been answered, I using the above solution and here is how I did it in java using Docker Java Client v3.2.5

    PortBinding portBinding = PortBinding.parse( hostPort + ":" + containerPort);
    HostConfig hostConfig = HostConfig.newHostConfig()
            .withPortBindings(portBinding);
    CreateContainerResponse container =
            dockerClient.createContainerCmd(imageName)
                    .withHostConfig(hostConfig)
                    .withExposedPorts(ExposedPort.parse(containerPort+"/tcp"))
                    .exec();