Ansible-VNC

This tool helps to install and configure the VNC Server/Desktop. By default, it uses TigerVNC and Gnome, but you can also choose from other options like:

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

Requirements

You need a recent version of Linux. Check the file meta/main.yml for details.

Example Playbook

There is an example playbook available in default.yml in the main directory. To run it, use the command:

ansible-playbook default.yml  

Instructions

Copy the contents from defaults/main.yml to your local groups_vars/all and change things as needed. Look at each variable closely. This is your "config file," so by changing the default variables, you can customize the installation. At least, you should set the vnc_users variable based on your environment. Other settings are optional.

Make sure to check the documentation in this repository:

• docs/admin-guide.md
• docs/users-guide.md

Quickstart

Most instructions assume you have a standard Ansible setup.

If you’ve just created a new remote test server and want to quickly install VNC without much hassle, you can run this command:

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

License

This tool is licensed under GPLv2.

Author Information

Created by Sam Darwin in 2018. Your feedback and bug reports are welcome!