RemoteDocker

Kathará can connect to a remote Docker daemon.

First you have to enable the Docker remote connection on the remote host. You need to stop the Docker daemon on the remote host and to restart it, specifying the tcp Socket option:

sudo dockerd -H tcp://<ip.to.the.host>

For more information about Docker daemon remote connection see the dockerd Guide

To access the Docker daemon remotely, you have to open the Kathará settings:

kathara settings

This will open the setting menu:

  ╔═════════════════════════════════════════════════════════════════════════╗
  ║                                                                         ║
  ║                            Kathara Settings                             ║
  ║                                                                         ║
  ╠═════════════════════════════════════════════════════════════════════════╣
  ║                                                                         ║
  ║                      Choose the option to change.                       ║
  ║                                                                         ║
  ╠═════════════════════════════════════════════════════════════════════════╣
  ║                                                                         ║
  ║    1 - Choose default manager                                           ║
  ║    2 - Choose default image                                             ║
  ║    3 - Automatically open terminals on startup                          ║
  ║    4 - Choose device shell to be used                                   ║
  ║    5 - Choose terminal emulator to be used                              ║
  ║    6 - Choose Kathara prefixes                                          ║
  ║    7 - Choose logging level to be used                                  ║
  ║    8 - Print Startup Logs on device startup                             ║
  ║    9 - Enable IPv6                                                      ║
  ║   10 - Automatically mount /hosthome on startup                         ║
  ║   11 - Automatically mount /shared on startup                           ║
  ║   12 - Enable multiuser scenarios                                       ║
  ║   13 - Insert a remote Docker Daemon URL                                ║
  ║   14 - Insert a Docker Daemon TLS Cert Path                             ║
  ║   15 - Exit                                                             ║
  ║                                                                         ║
  ║                                                                         ║
  ╚═════════════════════════════════════════════════════════════════════════╝

In the setting menu, select option 13 to insert the remote Docker daemon url.

  ╔═════════════════════════════════════════════════════════════════════════╗
  ║                                                                         ║
  ║                    Insert a remote Docker Daemon URL                    ║
  ║                                                                         ║
  ║                              Current: None                              ║
  ║                                                                         ║
  ╠═════════════════════════════════════════════════════════════════════════╣
  ║                                                                         ║
  ║               You can specify a remote Docker Daemon URL.               ║
  ║                            Default is None.                             ║
  ║                                                                         ║
  ╠═════════════════════════════════════════════════════════════════════════╣
  ║                                                                         ║
  ║    1 - Insert a remote Docker Daemon URL                                ║
  ║    2 - Reset value to Empty String                                      ║
  ║    3 - Return to Kathara Settings                                       ║
  ║                                                                         ║
  ║                                                                         ║
  ╚═════════════════════════════════════════════════════════════════════════╝

If required by the daemon, you can specify a Docker Daemon TLS Certificate path for the connection. To do so, select option 14.

  ╔═════════════════════════════════════════════════════════════════════════╗
  ║                                                                         ║
  ║                  Insert a Docker Daemon TLS Cert Path                   ║
  ║                                                                         ║
  ║                              Current: None                              ║
  ║                                                                         ║
  ╠═════════════════════════════════════════════════════════════════════════╣
  ║                                                                         ║
  ║    When using a remote Docker Daemon, a TLS Cert could be required.     ║
  ║                            Default is None.                             ║
  ║                                                                         ║
  ╠═════════════════════════════════════════════════════════════════════════╣
  ║                                                                         ║
  ║    1 - Insert a Docker Daemon TLS Cert Path                             ║
  ║    2 - Reset value to Empty String                                      ║
  ║    3 - Return to Kathara Settings                                       ║
  ║                                                                         ║
  ║                                                                         ║
  ╚═════════════════════════════════════════════════════════════════════════╝

Now, every Kathará requests to Docker is served by the remote daemon specified. The collision domains and devices are now deployed on the remote host.