Install tinc and set up a network using host variables.

• Install tinc
• Set configured tinc networks to start at boot.
• Create network configurations.
• Generate key pairs or use existing keys
• Create host configurations.
• Synchronize host configurations between participants

Supported distributions and operating systems:

• Linux
  • Debian (Jessie, Stretch)
  • Gentoo
• *BSD
  • FreeBSD

• Python 2

• Python 2

Gentoo specific configurations are in Gentoo.yml.

• tinc_service: Name of the tinc service.
  • Default: "tinc"
  • Gentoo: "tincd"
• tinc_switch_net_address_vpn_*interface*: Address of the tinc network in switched mode.
  • Default: "192.168.3.0/24"
• tinc_router_net_cidr_vpn_*interface)*: Netmask of the tinc network in routed mode.
  • Default: "32"
• tinc_key_bits: Bits to use when geneating the key.
  • Default: "4096"
• tinc_conf_dir: Where to store tinc configuration files.
  • Default: "/etc/tinc"
  • FreeBSD: "/usr/local/etc/tinc"

Each hosts tinc configuration is created using host variables. A configuration for a host connecting to two tinc networks, one of them using bridge br0 looks like this:

tinc_interfaces:
  tun0:
    hostname: "laptop"
    ip4: "192.168.3.30"
    netmask4: "255.255.255.0"
    name: "vps1"
    onboot: true
    master: false
    mode: "switch"
    bridge: "br0"
  tun1:
    hostname: "laptop"
    ip4: "192.168.2.30"
    netmask4: "255.255.255.0"
    name: "cg"
    onboot: false
    master: false
    mode: "router"

• name: Name of the tinc network.
• mode: switch or router network mode. See the tinc manual
• master: If set to true, this host used as a connection point for other hosts.
• bridge: If set to the name of a bridge interface, the tinc tunnel interface is added to that bridge.