Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.20

Documentation for other releases can be found by using the version selector in the top right of any doc page.

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