Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

ThinLinc Server

This role takes care of installing, configuring and starting the ThinLinc server software. The ThinLinc server software is not included in this role, and will have to be obtained separately.




Pull requests and issues are welcome.


Role Variables

thinlinc_accept_eula: "no"

By changing this to "yes", you agree to the terms specified in the ThinLinc End User License Agreement. NOTE: Setting this to yes is a requirement for installing and using ThinLinc.

thinlinc_version: "4.13.0"
thinlinc_build: "2253"
thinlinc_server_bundle_file: ""

ThinLinc version, build number and server bundle names.

thinlinc_autoinstall_dependencies: "yes"

When set to "yes", this will automatically install any required dependencies along with the ThinLinc software. If set to "no", the role assumes that you will take care of it.

thinlinc_email: "root@localhost"

Administrative email address to receive license warnings.

thinlinc_printers: "yes"

Whether to install the optional CUPS printer queues for ThinLinc.

thinlinc_webadm_password: "$6$7cc31a35e02e55ec$hm.1MsloeBJqNKljx9RH88Z/eRKZCka5ZlabkZGj0nYXh0IaxaiYucsDD.fGJ5sNPthWf63pXkCn9Nu0ua2Ye1"

ThinLinc Web Administration password. This default password is "thinlinc". Generate new hashes with /opt/thinlinc/sbin/tl-gen-auth.

thinlinc_agent_hostname: null

This allows you to modify the hostname reported by the agent server to the client on connecting. See ThinLinc in a NAT/Split-DNS Environment for details.

Setting thinlinc_agent_hostname to null sets this parameter to ansible_fqdn.


This role can be installed through ansible-galaxy with a requirements.yml file. Run ansible-galaxy install -r requirements.yml to install the role:

- src: https:///
  scm: git
  name: thinlinc-server
  version: v1.1

The role uses three groups - thinlinc_masters, thinlinc_agents and thinlinc-servers. Here's an example inventory file with one master server and three agent servers:




Now that we got both a role and an inventory, connect the dots by applying the thinlinc-server role to the thinlinc_servers group with a thinlinc.yml playbook:

- hosts: thinlinc_servers
    - { role: thinlinc-server, thinlinc_accept_eula: "yes" }

The final step is to apply the playbook to the inventory, like this:

ansible-playbook -i inventory thinlinc.yml