Installs and configures VNC Server/Desktop. By default, this will be TigerVNC and Gnome. However, you may easily select from a few others including

VNC Servers: TigerVNC, TightVNC, vnc4server Desktops: Gnome, Xfce4 Operating Systems: Ubuntu, Debian, Redhat, Centos

A recent version of Linux, see meta/main.yml.

An example playbook is included at default.yml in the root directory. To run it:

ansible-playbook default.yml

Copy the contents of defaults/main.yml to your local groups_vars/all and modify as necessary. Review each variable carefully. This serves as the "config file", so by customizing the default variables you adjust the installation. At minimum, the vnc_users variable in that file should likely be set for your particular environment. The other settings are optional.

Review the documentation included in this repo:
docs/admin-guide.md
docs/users-guide.md
docs/users-guide-systemd.md

Most of the instructions assume a standard Ansible infrastructure.

However, if you have just launched a single new remote test server, and would like to very quickly install VNC without much setup or configuration:

curl -sL https://raw.githubusercontent.com/sdarwin/Ansible-VNC/master/scripts/quickinstall.sh | sudo bash

GPLv2

By Sam Darwin, 2018. Feedback and bug reports welcome.