opkg(1)

📦 version 0.8.0, in nixos 26.05, nixpkgs unstable

👑 opkg(1) — the manual page but make it make sense 💅

okay so bestie, you've found it: the opkg(1) manual. Yes, that's the User Commands one. Yes, I read the whole thing so you don't have to. Grab a 🍓 and let's go.

✨ NAME ✨

opkg — a command line utility to install, upgrade and uninstall opkg software packages 🌸

🦋 SYNOPSIS 🦋

opkg [OPTIONS...] sub-command [ARGUMENTS...]

💜 DESCRIPTION 💜

opkg is a simple little utility to install, upgrade and uninstall opkg software packages. It's a lightweight package management system, and it's based on Ipkg — like, that's its whole ancestry. Lowkey iconic lineage, no cap. 👑

🎀 OPTIONS AND COMMANDS 🎀

🌈 SUB-COMMANDS : PACKAGE MANIPULATION 🌈

This is the section where we actually do stuff. Main character energy only. ✨

  • update — Update list of available packages
  • upgrade — Upgrade installed packages
  • dist-upgrade — Upgrade operation that allows package removal. Heads up: only available on the libsolv backend 👀
  • install <package(s)> — Install package(s)
  • configure <package(s)> — Configure unpacked package(s)
  • remove <packages|glob> — Remove package(s). The glob works like a shell globbing pattern and could be something like 'pkgname*', '*file*' or similar 🫶
  • clean — Clean internal cache
  • flag <flag> <packages> — Flag package(s). Available flags (one per invocation):
    • hold
    • noprune
    • user
    • ok
    • installed
    • unpacked
  • version — Print version

🧚 INFORMATIONAL SUB-COMMANDS 🧚

Not me being obsessed with a read-only section. This is the "just tell me things" era and honestly? It ate. 💖

  • list — List available packages
  • list-installed — List installed packages
  • list-upgradable — List installed and upgradable packages
  • list-changed-conffiles — List package configuration files which have been modified after installation
  • files <package> — List files belonging to package
  • search <file|glob> — List package providing file
  • find <regexp> — List packages with names or description matching regexp
  • info [package|glob] — Display all info for selected packages
  • status [package|glob] — Display all statuses for selected packages
  • download <package> — Download package to current directory
  • compare-versions <version1> <operator> <version2> — compare versions using following operators:
    • << — less than
    • < — less than or equal to
    • <= — less than or equal to
    • = — equal to
    • >= — greater than or equal to
    • > — greater than or equal to
    • >> — greater than
okay bestie I'm just the messenger 🙈 — that's exactly how the page lists the operators, duplicates and all. Don't come for me, come for the docs.
  • print-architecture — List installable package architectures
  • depends [-A] <package(s)|glob>
  • whatdepends [-A] <package(s)|glob>
  • whatdependsrec [-A] <package(s)|glob>
  • whatrecommends [-A] <package(s)|glob>
  • whatsuggests [-A] <package(s)|glob>
  • whatprovides [-A] <package(s)|glob>
  • whatconflicts [-A] <package(s)|glob>
  • whatreplaces [-A] <package(s)|glob>
  • verify <package(s)|glob> — Verifies the integrity of <pkg>, or all packages if omitted, by comparing the md5sum of each file with the information stored on the opkg metadata database. Detective mode fr fr 🔍

⭐ OPTIONS ⭐

The flags. The seasoning. The little guys that change everything. 🎀

  • -A — Query all packages not just those installed
  • -V <level>, --verbosity <level> — Set verbosity level to level. Verbosity levels:
    • 0 — errors only
    • 1 — normal messages (default)
    • 2 — informative messages
    • 3 — debug
    • 4 — debug level 2
  • -f <conf_file>, --conf <conf_file> — Use conf_file as the opkg configuration file
  • --cache-dir <directory> — Use a package cache
  • -t <directory>, --tmp-dir <directory> — Specify directory as temporary directory
  • -l <directory>, --lists-dir <directory> — Specify directory as package lists directory
  • -d <dest_name>, --dest <dest_name> — Use dest_name as the the root directory for package installation, removal, upgrading. dest_name should be a defined dest name from the configuration file, (but can also be a directory name in a pinch). iykyk 💅
  • -o <directory>, --offline-root <directory> — Use directory as the root directory for offline installation of packages.
  • --add-dest <name>:<path> — Register path as installation target name for use in conjunction with --dest
  • --add-arch <arch>:<prio> — Register the package architecture arch with the numeric priority prio. Lower priorities take precedence.
  • --add-exclude <name> — Register package to be excluded from install
  • --add-ignore-recommends <name> — Register package to be ignored as a recomendee
  • --prefer-arch-to-version — Use the architecture priority package rather than the higher version one if more than one candidate is found.
  • --combine — Combine upgrade and install operations, this may be needed to resolve dependency issues. Only available for the internal solver backend.
  • --fields <field1>,<field2> — Limit display information to the specified fields plus the package name. Valid for info and status.
  • --short-description — Display only the first line of the description.
  • --size — Print package size when listing available packages

🔥 FORCE OPTIONS 🔥

⚠️ real talk bestie: these override the checks that exist for a reason. They're not toys. Use them when you genuinely mean it, and know what you're asking for. 😭
  • --force-depends — Install/remove despite failed dependencies
  • --force-maintainer — Overwrite preexisting config files
  • --force-reinstall — Reinstall package(s)
  • --force-overwrite — Overwrite files from other package(s)
  • --force-downgrade — Allow opkg to downgrade packages
  • --force-space — Disable free space checks
  • --force-postinstall — Execute package postinstall scripts in offline installation mode
  • --force-remove — Remove package even if prerm script fails
  • --force-checksum — Don't fail on checksum mismatches
  • --noaction — No action - test only
  • --download-only — No action - download only
  • --nodeps — Do not follow dependencies
  • --install-recommends — Install any recommended packages. This flag overrides the no_install_recommends configuration option.
  • --no-install-recommends — Do not install any recommended packages
  • --force-removal-of-dependent-packages — Remove package and all dependencies
  • --autoremove — Remove packages that were installed automatically to satisfy dependencies
  • --host-cache-dir — Don't place cache in offline root dir
  • --volatile-cache — Use volatile cache. Volatile cache will be cleared on exit

💀 REPORTING BUGS 💀

Found a bug? Say it with your chest, bestie — report it here:

https://bugzilla.yoctoproject.org/buglist.cgi?product=opkg

Copyright © Opkg development team.

Copyright © Ipkg development team.

🫶 and that's the whole page! This was opkg version 0.8.0, dated January 2025, brought to you by the opkg(1) girlies. Go forth and manage your packages, queen. Periodt. 👑✨

📦 where this page comes from