Documentation

hostname - Manage hostname

New in version 1.4.

Synopsis

Set system’s hostname. Currently implemented on Debian, Ubuntu, Fedora, RedHat, openSUSE, Linaro, ScientificLinux, Arch, CentOS, AMI. Any distribution that uses systemd as their init system. Note, this module does NOT modify /etc/hosts. You need to modify it yourself using other modules like template or replace.

Requirements (on host that executes module)

  • hostname

Options

parameter required default choices comments
name
yes
    Name of the host

    Examples

    - hostname: name=web01
    

    This is a Core Module

    For more information on what this means please read Core Modules

    For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.