deb-postinst(5)

✨ NAME ✨

Okay so bestie, this is deb-postinst(5) β€” the manual page for the package post-installation maintainer script. It’s giving β€œthe script that handles post-install business,” and we are gonna get you fluent in it, no cap. πŸ’–


πŸŽ€ SYNOPSIS πŸŽ€

The synopsis is literally just this path, periodt:

DEBIAN/postinst

That’s the whole vibe. ✨


πŸ’… DESCRIPTION πŸ’…

A package can perform several post-installation actions via maintainer scripts, by including an executable postinst file in its control archive β€” that’s DEBIAN/postinst during package creation, iykyk. So yes: executable file, control archive, package creation. Slay. 🫢

The script can be called in the following ways β€” keep these exact forms in your notes, bestie, fr fr:

  • postinst configure old-version β€” after the package was installed. 🌸
  • postinst triggered "trigger-name..." β€” after the package was triggered. The list of space-separated trigger-names is passed as the second argument. Yes, space-separated, all of them, that’s the whole point. πŸ¦‹
  • old-postinst abort-upgrade new-version β€” if prerm fails during upgrade or fails on failed-upgrade. 😭
  • old-postinst abort-remove β€” if prerm fails during remove. πŸ’€
  • postinst abort-deconfigure in-favour new-package new-version with the bracketed continuation [ removing old-package old-version ] β€” if prerm fails during deconfigure in-favour of a package. Here’s the exact shape:
postinst abort-deconfigure in-favour new-package new-version
       [ removing old-package old-version ]

The bracket line is part of the form, not a drill. πŸŽ€

  • postinst abort-remove in-favour new-package new-version β€” if prerm fails during remove in-favour for replacement due to conflict. πŸ‘‘

Vibe check: all of those conditions are exact, and prerm is the main character of the β€œif it fails” moments. Periodt. πŸ’…


🌈 SEE ALSO 🌈

  • dpkg(1) β€” go read it, bestie, it’s iconic and it’s literally the reference. πŸ‘‘β­

This page is from the dpkg suite, version 1.23.11-dirty, dated 2026-09-09 β€” and it’s literally deb-postinst(5). Stay executable, bestie πŸ’–βœ¨πŸ«Ά

πŸ“¦ where this page comes from