atomic_host - Manage the atomic host platform

New in version 2.2.


  • Manage the atomic host platform
  • Rebooting of Atomic host platform should be done outside this module


parameter required default choices comments
no latest
The version number of the atomic host to be deployed. Providing latest will upgrade to the latest available version.

aliases: version


# Upgrade the atomic host platform to the latest version (atomic host upgrade)
- atomic_host:
    revision: latest

# Deploy a specific revision as the atomic host (atomic host deploy 23.130)
- atomic_host:
    revision: 23.130

Return Values

Common return values are documented here Return Values, the following are the fields unique to this module:

name description returned type sample
msg The command standard output always string Already on latest



  • Host should be an atomic platform (verified by existence of ‘/run/ostree-booted’ file)


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


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, Helping Testing PRs and Developing Modules.