Documentation

distro_package

Auto-detect the distribution’s package manager and install/remove packages using the appropriate backend (apk, apt, dnf, pacman, zypper, opkg).

This module provides a unified, idempotent interface for package management across different Linux distributions. It automatically detects the appropriate package manager based on the system and performs the requested operation.

Attributes

check_mode:
  support: full

Parameters

Parameter	Type	Values	Description
name	array		Name or list of names of the package(s) to install, upgrade, or remove.
state	string	absent present latest	Whether to install (`present`), remove (`absent`), or ensure latest version (`latest`). `present` will simply ensure that a desired package is installed. `absent` will remove the specified package. `latest` will update the specified package to the latest version. [default: `"present"`]
update_cache	boolean		Whether or not to refresh the package index. This can be run as part of a package installation or as a separate step. [default: `false`]
upgrade	boolean		Whether or not to upgrade all packages to the latest version available. [default: `false`]

Example

- name: Install packages using auto-detected package manager
  distro_package:
    name:
      - curl
      - vim
      - git
    state: present
    update_cache: true

- name: Remove a package
  distro_package:
    name: nginx
    state: absent

- name: Ensure latest version of packages
  distro_package:
    name:
      - curl
      - jq
    state: latest

- name: Upgrade all packages
  distro_package:
    upgrade: true

- name: Update cache and upgrade all packages
  distro_package:
    update_cache: true
    upgrade: true