opkg Operations¶

Manage packages on OpenWrt using opkg + update - update local copy of package information + packages - install and remove packages

See https://openwrt.org/docs/guide-user/additional-software/opkg

OpenWrt recommends against upgrading all packages thus there is no opkg.upgrade function

Note: as of OpenWrt Release 2025.12_, OpenWrt uses apk.

.. _2025.12: https://openwrt.org/releases/25.12/notes-25.12.0#switch_package_manager_from_opkg_to_apk

Facts used in these operations: opkg.OpkgPackages.

opkg.packages¶

Add/remove/update opkg packages.

opkg.packages(
         packages: str | list[str] = '',
         present: bool = True,
         latest: bool = False,
         update: bool = True,
         **kwargs,
    )

• packages: package or list of packages to that must/must not be present
• present: whether the package(s) should be installed (default True) or removed
• latest: whether to attempt to upgrade the specified package(s) (default False)
• update: run opkg update before installing packages (default True)

Not Supported: Opkg does not support version pinning, i.e. <pkg>=<version> is not allowed and will cause an exception.

Examples:

from pyinfra.operations import opkg
# Ensure packages are installed (will not force package upgrade)
opkg.packages(['asterisk', 'vim'], name="Install Asterisk and Vim")

# Install the latest versions of packages (always check)
opkg.packages(
    'vim',
    latest=True,
    name="Ensure we have the latest version of Vim"
)

opkg.update¶

Update the local opkg information.

opkg.update**kwargs,    )