This is an old revision of the document!
Docker - Enable Docker Remote API
Docker provides a nice remote REST API.
Edit or create a systemd dropin file under: /etc/systemd/system/docker.service.d/remote-api.conf
With the contents:
- /etc/systemd/system/docker.service.d/remote-api.conf
[Service] ExecStart= ExecStart=/usr/bin/dockerd -H tcp://127.0.0.1:1234 -H unix:///var/run/docker.sock
NOTE: The double ExecStart is necessary!
-H fd:// can also be used to use systemd's socket activation feature to refer to /lib/systemd/system/docker.socket, instead of the -H unix:///var/run/docker.sock.
It is recommended binding on 127.0.0.1 instead of 0.0.0.0, unless you have a good reason!
This will have Docker bind to port 1234 which will be used by the Docker Remote API.
One you have saved your changes, you will need to restart the Docker process by running the following command:
sudo systemctl daemon-reload sudo systemctl restart docker
Check that the dockerd process listening on port 1234:
sudo ss -tulpn | grep 1234 tcp6 0 0 :::1234 :::* LISTEN 1836/dockerd
To test that the Docker Remote API has been properly enabled, we will list the Images currently in Docker:
sudo docker images
Test by performing a GET operation on the following URL: http://172.30.0.199:1234/images/json as described in the Docker Remote API.
You can also easily test this by using CURL on the command-line by running the following command:
curl -X GET http://172.30.0.199:1234/images/json