Taisun allows you to launch and manage a web based virtual desktop running inside Docker. In this document we will go over launching these desktops and some basics on the interface.
Launching your first desktop
When you first click on the VDI tab of Taisun you will be informed that you need to launch a Guacamole server container:
This backend container is needed to translate the VNC connection to the desktops to your web browser, more about the Guacamole project can be found here https://guacamole.apache.org/ .
Once the Gaucamole container is running on your machine you will be presented with a new screen on the VDI tab:
To fire up a desktop click on the "Launch Desktop" button and fill out your desired configuration:
Once the desktop is launched simply click on the launch button to be brought to your desktop.
Basic Usage VDI
A Linux desktop is a powerful tool, anything you could do on a normal Linux desktop you should be able to achieve inside of this web based Docker container.
On first launch you will see a basic XFCE desktop:
On the middle left of the interface there is a small arrow, this can be clicked on to display the VDI sidebar:
This sidebar can also be shown or hidden using the keyboard combination:
ctrl + alt + shift
The keyboard shortcut can be useful when you need to quickly paste information in and out of the desktops clipboard.
Because this desktops interface is running inside of your web browser you will need to use the clipboard text area in the sidebar to put data into it and take data out of it.
When text is selected and copied inside of the desktop it will populate this text area IE:
Also inversely when you paste data into this box it will be available in the VDI clipboard:
At first this can be a little bit of a pain, but it is necessary to translate the clipboard from the host to the client VDI due to web browsers lacking a method of doing this automatically in a sane manner. Getting used to the keyboard shortcut (ctrl + alt + shift ) to bring up the sidebar selecting all of the text with ctrl + a and copying with ctrl + c becomes much easier as you use it more.
If you are on a device that lacks a physical keyboard you will want to launch a touch keyboard from the sidebar: ( Touch button at the top)
The keyboard does occupy most of the screen real estate and is designed to be used as a stop gap for infrequent typing not as a full time interface.
This can be useful if you need to restart a service on your machine from your phone or tablet.
Unlike Remote Desktop Protocol which can resize a desktop to any arbitrary dimensions, A Linux desktop in a saved state needs to have all of its available resolutions defined and made available to Xorg on startup of the X server. Virtual frame buffers can be created with arbitrary dimensions but would destroy your current working environment on recreation.
What this means for you is there is only a finite number of available resolutions available for the desktop to resize to (currently ranging from 1024x512 to 2560x1440 ).
On the initial connection to the Desktop your browser will send it's window dimensions to the container and request a resize at that exact dimension, if that pixel perfect resolution is not available it will try one slightly smaller. You might notice some white bars in the viewport of your browser if your window is at a non full screen size.
If you resize your window while working you will need to either reload the window to trigger another resize attempt or manually set the resolution via the sidebar.