hostname - Manage hostname

• Synopsis
• Requirements (on host that executes module)
• Options
• Examples
  • Status

Synopsis

• Set system’s hostname, supports most OSs/Distributions, including those using systemd.
• Note, this module does NOT modify /etc/hosts. You need to modify it yourself using other modules like template or replace.
• Windows, HP-UX and AIX are not currently supported.

Requirements (on host that executes module)

• hostname

Options

parameter	required	default	choices	comments
name	yes			Name of the host

Examples

- hostname:
    name: web01

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

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