Default variable details

Some of debops-contrib.dropbear_initramfs default variables have more extensive configuration than simple strings or lists, here you can find documentation and examples for them.


The dropbear_initramfs__interfaces and similar dictionaries behave similar to the ifupdown__*_interfaces dictionaries of the debops.ifupdown role. Refer to the documentation of debops.ifupdown for details.

Compared to the debops.ifupdown, only a limited subset of parameters is currently supported:

Optional. Anything other than ether will be ignored.
Optional. IPv4 configuration method used by a given interface. If you set this parameter to False, no IPv4 configuration will be applied. Currently only static (default) and False is supported.
Optional. IPv6 configuration method used by a given interface. If you set this parameter to False, no IPv6 configuration will be applied. Currently only static (default) and False is supported.
address or addresses
Optional. A string or a list of IPv4 and/or IPv6 addresses to set on a given network interface, in the form of ipaddress/prefix or CIDR. Remember that you need to specify the host IP address and not the network; the is the correct notation, and is incorrect.
gateway or gateways
Optional. Specify the IPv4 or IPv6 address of the network gateway to which outgoing packets will be directed. If it's a list of addresses, first valid address for a network type will be used as the gateway.


Configure eth0 with a global IPv6 address.

    inet: False
    inet6: 'static'
      - '2001:db8::23/64'
      - '2001:db8::'


The dropbear_initramfs__authorized_keys and similar variables are used to define what SSH keys should be allowed for remote initramfs login. Each list item is a dictionary with the following supported options:

Required. String containing either a SSH public key, or an URL to a resource which returns a file with SSH public keys (only one URL is allowed at the moment), or a list of SSH public keys.

Optional. String or list of SSH options which should be set for each key specified on the item.sshkeys list. Refer to dropbear(8) for details.

If this parameter is not specified, SSH public keys will use options set in the dropbear_initramfs__authorized_keys_options variable. To override this variable for a particular entry, set the item.options parameter as empty string or list.

The specified SSH key options are applied to all keys specified in the item.sshkeys parameter in this specific entry. To use different key options for different SSH keys, specify them in separate entries on the list.

Optional. Additional set of options to add to the SSH public keys. This can be used with item.options parameter to easily combine a list of options from another variable with a custom additional options.
Optional, boolean. If defined and True, the role will remove all other SSH public keys and set only the SSH public keys defined by item.sshkeys.
Optional. If undefined or present, the SSH public keys specified in the item.sshkeys parameter will be added. If absent, the specified SSH public keys will be removed.


Set SSH keys from a file on the Ansible Controller as the only allowed keys for remote initramfs login:

  - sshkeys: '{{ lookup("file", "/path/to/") }}'
    exclusive: True

Ensure that given SSH public keys are allowed for remote initramfs login:

  - sshkeys: [ 'ssh-rsa AAAAB3NzaC1yc2EAAAA...', 'ssh-rsa AAAAB3NzaC1yc2EAAAA...' ]