Documentation

hostname - Manage hostname

New in version 1.4.

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

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.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

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