Docker Credential Helper

fioctl has a Docker credential helper, providing easier access to hub.foundries.io. This enables the use of Docker commands from a personal computer, such as a laptop.

Note

The credentials will need the “containers:read” scope to work with Docker.

To do this, run:

sudo fioctl configure-docker

This creates a symlink named docker-credential-fio in the directory of the docker client binary, pointing to fioctl.

Important

Because the Docker client is usually somewhere under /usr, you will want to run fioctl configure-docker with root permission.

The helper then updates your Docker config file, which is located under $HOME/.docker.

Note

The helper configures for the current user and not the entire system. If you are logged in as root, then it would be in the root home directory, which you should generally avoid doing.

Now, Docker commands will just work.

Example:

docker pull hub.foundries.io/FACTORY/shellhttpd

Important

To run Docker commands without sudo, you will need to gain access to /var/run/docker.sock. You can do this by adding yourself to the Docker group.

You can also run fioctl configure-docker --help for more information and available flags.