Ansible Role for TigerVNC

This guide helps you install and set up TigerVNC on your machine.

GitHub	GitLab	Downloads	Version

Example Playbook

Here’s a simple example you can use, from molecule/default/converge.yml:

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: robertdebock.tigervnc

Make sure your system is ready first. This preparation is done with molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: robertdebock.bootstrap
    - role: robertdebock.core_dependencies
    - role: robertdebock.gnome
    - role: robertdebock.users
      users_groups:
        - name: vncgroup
      users:
        - name: vncuser
          sudo_options: "ALL=(ALL) NOPASSWD: ALL"
          group: vncgroup

For a detailed explanation on using these roles, check out this guide.

Role Variables

You can find the default variable values in defaults/main.yml:

---
# Default settings for TigerVNC

# The TigerVNC server runs under a specific user and group. This user
# is created in `molecule/default/prepare.yml`. You can either use
# an existing user or create a new one with
# [ansible-role-users](https://galaxy.ansible.com/robertdebock/users)
tigervnc_username: vncuser
tigervnc_groupname: vncgroup

# You need a password to connect to the TigerVNC server.
tigervnc_password: vncpass

# Set to true if using an existing user's VNC password
tigervnc_user_exists: false

# Define the desktop session to connect to, e.g., gnome-session
tigervnc_desktop_session: gnome-session

Requirements

You need the pip packages listed in requirements.txt.

Used Roles

The system is prepared using the following roles, but you can choose different methods.

Requirement	GitHub	GitLab
robertdebock.bootstrap
robertdebock.core_dependencies
robertdebock.gnome
robertdebock.users

Context

This role works with many other compatible roles. For more information, check out the documentation.

Here's a visual overview of the related roles:

Compatibility

This role has been tested on these container images:

Ansible version 2.12 or higher is required. Testing has been done with:

• Previous versions.
• Current version.
• Development version.

If you encounter any issues, please report them on GitHub.

License

This role is licensed under Apache-2.0.

Author Information

Authored by robertdebock.

If you find this helpful, consider supporting me.