Skip to content

Running the Client in a Container

Once you have a docker image with the tag pcoip-client, you can run the client in a docker container. Execute the following command to build the pcoip-client docker image:

$ docker run -d --rm -h myhost -v $(pwd)/.config/:/home/myuser/.config/Teradici -v $(pwd)/.logs:/tmp/Teradici/$USER/PCoIPClient/logs -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY pcoip-client
The following table outlines the parameters used in the example above:

Parameters Definition
-d Runs the docker container in detached mode (optionally the client could be run in foreground mode).
-rm Cleans up the container filesystem after the container exits.
-h Specifies the hostname to use for the container.
-v Maps local volumes to volumes in the container.
$(pwd)/.config/:/home/myuser/.config/Teradici This allows persistent storage of the client configuration and saved connections between container runs. The files are stored in .config in the current directory.
$(pwd)/.logs:/tmp/Teradici/$USER/PCoIPClient/logs This allows for persistent storage of the client log files after the client exits. The log files are stored in .logs in the current directory.
/tmp/.X11-unix:/tmp/.X11-unix This allows access to the X11 display from the container.
-e Set environment variable
DISPLAY=$DISPLAY This sets the correct X11 display within the container.
pcoip-client This is the tag of the container to run, the pcoip-client tag was created in the previous docker build step.

Support Conditions and Limitations