Ansible role for ZeroTier

This ansible role provides full control of node settings through the ZeroTier API as well as local settings.

Features

• Joining/Leaving of nodes from networks using API calls to the local ZeroTier node API
• Configuration of node settings in a network the node has joined
• Local configuration of node settings (localconfig)

Tested Operating Systems

• Ubuntu 18.04
• Ubuntu 20.04
• Ubuntu 22.04

Parameters

zerotier_version

The ZeroTier version that will be installed

zerotier_networks

Configuration of ZeroTier networks that the node will join.

It uses the following structure

{{zerotier network id}}:
    apikey: {{zerotier_api_key}}
    nodedescription: zerotier node description
    config: {{zerotier_config}}

zerotier_network_id

This is the ID of the ZeroTier network the node is to join

zerotier_api_key

This is the API key used for your ZeroTier account. Can be retrieved from ZeroTier Central -> Account -> New Token

zerotier_config

This dict sets any config under the config section of a network member. See here for possible configuration options. Very important for authorizing (i.e. authorized: True) nodes automatically.

zerotier_localconfig

This dict contains configuration for ZeroTier Local Configuration (aka local.conf). It simply converts the YAML entered here to JSON and saves it as local.conf.

Example Deployment

zerotier_version: 1.10.6
zerotier_networks:
  12345:
    apikey: myapikey
    nodedescription: myserver
    enabled: True
    config:
      authorized: True
      tags:
        - [1001, 2001]