Ansible collection: foundata.podman

This repository contains the foundata.podman Ansible Collection.

It provides resources to manage and use Podman, a daemonless container engine, and to deploy OCI container workloads as systemd services via Quadlet units.

⭐ Found this useful? Support open-source and star this project:

Table of contents

• Included content
• Dependencies
• Licensing, copyright
• Author information

Included content

Role: foundata.podman.host

The host role installs and configures Podman and its host-wide settings, including storage, registries, automatic updates, Docker compatibility, and rootless user enablement. Its README.md covers configuration, usage examples, and more:

• Ansible role: foundata.podman.host
  • Table of contents
  • Example playbooks, using this role
  • Centralizing rootless storage
  • Supported tags
  • Role variables
    • host_podman_state
    • host_podman_autoupgrade
    • host_podman_service_state
    • host_podman_containers
    • host_podman_storage
    • host_podman_registries
    • host_podman_policy
    • host_podman_auto_update
    • host_podman_auto_update_timer_settings
    • host_podman_docker_compat
    • host_podman_rootless_users
      • host_podman_rootless_users['name']
      • host_podman_rootless_users['state']
      • host_podman_rootless_users['linger']
      • host_podman_rootless_users['subuid']
      • host_podman_rootless_users['subgid']
      • host_podman_rootless_users['auto_update']
      • host_podman_rootless_users['containers']
      • host_podman_rootless_users['storage']
      • host_podman_rootless_users['registries']
    • host_podman_selinux_manage
    • host_podman_selinux_label_paths
  • Dependencies
  • Compatibility
  • External requirements

Role: foundata.podman.quadlet

The Quadlet role deploys and manages rootful or rootless OCI applications as declarative Podman Quadlet units, together with secrets, registry authentication, directories, files, and generated systemd services. Its README.md covers configuration, usage examples, and more:

• Ansible role: foundata.podman.quadlet
  • Table of contents
  • Example playbooks, using this role
  • Run-once containers and timers
  • Rootless applications: data, UID mapping and SELinux
  • Supported tags
  • Role variables
    • quadlet_podman_app
    • quadlet_podman_state
    • quadlet_podman_service_state
    • quadlet_podman_user
    • quadlet_podman_units
      • quadlet_podman_units['name']
      • quadlet_podman_units['type']
      • quadlet_podman_units['sections']
      • quadlet_podman_units['service_state']
    • quadlet_podman_systemd_units
      • quadlet_podman_systemd_units['name']
      • quadlet_podman_systemd_units['sections']
      • quadlet_podman_systemd_units['service_state']
    • quadlet_podman_unit_defaults
      • quadlet_podman_unit_defaults['container']
      • quadlet_podman_unit_defaults['pod']
      • quadlet_podman_unit_defaults['volume']
      • quadlet_podman_unit_defaults['network']
      • quadlet_podman_unit_defaults['kube']
      • quadlet_podman_unit_defaults['image']
      • quadlet_podman_unit_defaults['build']
      • quadlet_podman_unit_defaults['artifact']
    • quadlet_podman_secrets
      • quadlet_podman_secrets['name']
      • quadlet_podman_secrets['value']
      • quadlet_podman_secrets['state']
    • quadlet_podman_registry_auth
      • quadlet_podman_registry_auth['registry']
      • quadlet_podman_registry_auth['username']
      • quadlet_podman_registry_auth['password']
    • quadlet_podman_directories
      • quadlet_podman_directories['path']
      • quadlet_podman_directories['owner']
      • quadlet_podman_directories['group']
      • quadlet_podman_directories['mode']
      • quadlet_podman_directories['state']
    • quadlet_podman_files
      • quadlet_podman_files['dest']
      • quadlet_podman_files['content']
      • quadlet_podman_files['owner']
      • quadlet_podman_files['group']
      • quadlet_podman_files['mode']
      • quadlet_podman_files['state']
    • quadlet_podman_min_podman_version
  • Dependencies
  • Compatibility
  • External requirements

Dependencies

See dependencies in galaxy.yml.

Licensing, copyright

Copyright (c) 2026 foundata GmbH

This project is licensed under the GNU General Public License v3.0 or later (SPDX-License-Identifier: GPL-3.0-or-later), see LICENSES/GPL-3.0-or-later.txt for the full text.

The REUSE.toml file provides detailed licensing and copyright information in a human- and machine-readable format. This includes parts that may be subject to different licensing or usage terms, such as third-party components. The repository conforms to the REUSE specification. You can use reuse spdx to create a SPDX software bill of materials (SBOM).

Author information

This project was created and is maintained by foundata GmbH.

Initially based on an Ansible skeleton developed by foundata.