Documentation

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

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

package

Generic package manager module that auto-detects the system’s package manager.

This module provides a unified interface for package management across different Linux distributions. It automatically detects the appropriate package manager (apk, apt, dnf, pacman, or zypper) based on the system.

Attributes

check_mode:
  support: partial

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`). [default: `"present"`]
update_cache	boolean		Whether to update the package cache before installing. [default: `false`]
upgrade	boolean		Whether to upgrade all packages to the latest version available. [default: `false`]
use_manager	string	apk apt dnf pacman zypper	Force a specific package manager to be used instead of auto-detection. If not specified, the module will auto-detect the system’s package manager.

Example

- name: Install packages using auto-detected package manager
  package:
    name:
      - curl
      - jq
    state: present

- name: Remove a package
  package:
    name: vim
    state: absent

- name: Update all packages
  package:
    upgrade: true

- name: Install from specific package manager
  package:
    name: nginx
    use_manager: apt