.udeb File Extension

Learn what a .udeb file is, how to inspect a Debian Installer package safely, how Poly supports it, and when to use a regular DEB instead.

File extension details for .udeb

Storage Only
File typeDebian Installer micro package
MIME type
EncodingBinary ar archive containing control and data tar archives
Operating systemsLinux, Windows, macOS
Opens withdpkg-deb, dpkg, udpkg, ar
Poly supportYes. Poly stores, syncs, shares, versions, and downloads UDEB packages.
Indexed by PolyPartial. Poly indexes the filename and ordinary file properties, not package metadata or archived contents.
Preview in PolyNo. Download the package to inspect it with Debian package tools.
Poly agentNo. The Poly agent cannot read the control metadata, scripts, or payload inside a UDEB package.

What kind of file is a .udeb?

A .udeb file is a micro-deb package used as a component of the Debian Installer. It is a reduced form of a Debian binary package, not an ordinary application package for an installed Debian or Ubuntu system. Debian uses the suffix for installer components such as hardware detection, partitioning, and the installer menu.12

UDEB and .deb files share the same package structure. A modern package uses an ar container with debian-binary, control.tar.*, and data.tar.* members. IANA lists both suffixes for application/vnd.debian.binary-package and identifies !<arch>\ndebian-binary as the distinguishing start of a version 2.0 package.3

The initial !<arch>\n bytes identify an ar archive, not necessarily a valid UDEB. Check the required members and control metadata. Renaming a .deb, TAR archive, or other file to .udeb does not create an installer component.

How do I open a .udeb on my computer?

On Debian, Ubuntu, or another Linux system with dpkg, inspect a package without installing it:

dpkg-deb --info component.udeb
dpkg-deb --contents component.udeb

dpkg-deb understands Debian package metadata and can extract the payload into a separate directory.4 A generic ar tool can expose the outer members, but it does not interpret dependencies or installer-specific fields. On Windows, use Debian tools through WSL or a Linux virtual machine. On macOS, a Linux virtual machine or container is the most predictable option.

Do not install a UDEB on a normal system with dpkg -i. Debian's installer documentation says the relaxed packaging rules make UDEBs unsuitable for ordinary installation. Inside the Debian Installer environment, the compact udpkg tool handles them.12

Package inspection still processes complex archive and compression data. Do not inspect an untrusted UDEB as root, and never run included scripts merely to discover what the package contains.34

Poly support for .udeb

Poly stores, syncs, shares, versions, downloads, and finds UDEB files by filename and ordinary file properties. This makes Poly useful for keeping installer artifacts with build notes or release materials.

Poly does not unpack UDEB containers, index their control fields or payloads, generate a package preview, or expose their contents to the Poly agent. Download a package and use dpkg-deb when you need to review its architecture, dependencies, scripts, or files.

History of .udeb

The name means “micro-deb.” Debian created this package class for the Debian Installer, where components must stay small because much of installation runs in RAM. UDEBs waive normal package requirements and commonly omit material such as changelogs, licenses, manual pages, and checksums. Their source packages still carry the appropriate licensing and history.12

That smaller footprint comes with a narrower lifecycle. UDEBs are installer building blocks rather than packages intended to be upgraded or removed on a running system. A package's Package-Type: udeb control field tells Debian build tools to apply the installer-package rules.1

Working with .udeb and alternatives

Choose the artifact that matches the task:

NeedBetter fit
Add a component to Debian Installer.udeb built for the matching installer suite and architecture
Install software on Debian or Ubuntu.deb from a trusted repository
Distribute Debian source.dsc plus its referenced source archives
Share files without package behaviorTAR or ZIP

Do not convert a normal DEB to UDEB by stripping files or changing the suffix. Installer packages have different dependency lines, size expectations, control fields, and runtime assumptions. Build one through Debian packaging tools and test it in the intended Debian Installer image.

Footnotes

  1. Debian Installer Project. D-I Components or UDEBs. 2 3 4
  2. Debian Project. Debian Reference: Debian Package File Names. 2 3
  3. Internet Assigned Numbers Authority. application/vnd.debian.binary-package Media Type Registration. 2
  4. Debian dpkg maintainers. dpkg-deb(1): Debian Package Archive Manipulation Tool. 2
© Poly Corp. 2026