Translation(s): English - Español - Português (Brasil) - Italiano - Svenska - Русский
This is the packaging portal, for people who want to create new Debian packages. To understand how to install and remove packages, see PackageManagement. If you want general info on software in Debian, see Software.
Contents
Introduction
There is no single "correct" way to learn about creating packages. For example, you might use a trivial package manager like equivs to manage configuration files on your personal server, or you might learn a git-based workflow to get new packages into Debian, or you might get your project to follow the upstream guide and leave packaging to someone else.
If you're not sure whether packaging is the right solution for your problem, the packaging FAQ or mentiors FAQ might answer your questions.
Trivial packages
Resources to help make very simple packages (no compiled files, will never be released publicly etc.):
create a .deb for private use shows how to make a basic package in 5 minutes
equivs can make metapackages (packages that simply depend on other packages)
Packaging/HackingDependencies - hacking dependencies with equivs
General packaging information
Debian packaging can be learnt by example as much as by theory: Find well-maintained packages, and see how they do it!
Resources about creating packages, which you may or may not release publicly some day:
PackagingWithGit explains how to use Debian's modern tools
- a tutorial series from 2025 by Otto Kekäläinen explains a git-based packaging workflow:
learn Debian Packaging in steps takes you from new to advanced packaging levels (by the JavaScript team)
Historical information - Debian's modern toolkit is often best understood by learning what it was built on:
Debian Trends - how packaging practices have changed over the years
Packaging/BuildingWithoutHelper - how to make a Debian package without using any helpers at all (as of 2005)
Debian New Maintainers' Guide covers Debian source package fundamentals (as of 2010)
Debian Packaging Tutorial tells you what you really need to know about Debian packaging
- a tutorial series from 2010-2011:
Packaging/Intro explains packaging from scratch (as of 2010)
the building tutorial explains applying changes to an existing package
later simplified
advanced building tips covers some details that didn't fit in the other tutorials
setting up a Debian unstable system discusses options for manually creating a package-building environment
General tools and policies
Reference documentation, to answer specific questions:
the Debian Policy Manual - the technical requirements that each package in Debian must satisfy
the Guide for Debian Maintainers covers Debian source package fundamentals
the Developers Reference gives an overview of recommended procedures and available resources
AutomaticPackagingTools compares tools that create Debian packages
Projects/DebSrc3.0 - details about the "3.0 (quilt)" and "3.0 (native)" source package formats
Documentation about files in your package's debian/ directory:
debian/changelog - changes between versions of your package
debian/copyright - copyright information about the upstream package
debian/patches - debian-specific patches to the upstream code
debian/upstream - files describing the upstream project
debian/upstream/edam - formal categorisation from the EDAM ontology
debian/upstream/metadata - miscellaneous information
debian/watch - check for upstream updates
codesearch.debian.net lets you find real-world examples
Standard tools you will probably need:
Lintian, piuparts, autopkgtest and blhc to test and debug your packages
More tools you might want to use:
devscripts to make your life easier
dh-make to convert source archives into Debian package source
checkinstall to build binary .deb packages from installation scripts (make install...)
See also a comparison of tools that create Debian packages.
Team-specific tools and policies
Many of Debian's packaging teams have their own policies and/or tools:
Emacs Lisp team page
Golang packaging documentation
Haskell team page
Java packaging guide
JavaScript policy
Node.js packaging guide
Mono packaging guide
OCaml maintainers page
Perl packaging guide
Python library style guide
Ruby packaging guide
Packaging/ruby-team-meta-build - build scripts used by ruby team, helps testing reverse dependencies easily
Rust team page
Here are some guides from other teams:
Android tools team information
Debian GNOME Team guide
KDE Team home page
Debian Med team policy
Debian Multimedia packaging guide
Vim team packaging guide
Debian Science policy manual
fonts packaging policy
repackaging RPM source packages as .deb packages
see also using RPM in Debian
Task-specific guides
If you're trying to achieve a particular outcome:
DpkgConffileHandling - changing conffiles
let files from one package be temporarily replaced by files from another
upload source packages without binary packages
see also Debian archive
avoid keeping convenience copies of files from one project in another
the debconf developers guide explains how to ask the user questions during installation
Getting your package into Debian
Resources about getting a package published:
Mentors - sponsors/mentors for packages in specific areas of Debian
DebianMentorsFaq - FAQs for people looking for someone to sponsor an upload to Debian
Introduction for maintainers walks you through the process of getting packages accepted by Debian
introduction for reviewers explains how to help a maintainer
SponsorChecklist - Sponsor Checklist
Work-Needing and Prospective Packages - packages that have been requested for packaging, or need a new maintainer
Software that can't be packaged - projects that have already been found ineligible for inclusion in Debian
UpstreamGuide advises upstream maintainers how to support packaging
You will need a Debian Maintainer to review and sponsor uploading your package
See also
Other packaging-related pages
Debuginfod eliminates the need for users to install debuginfo packages in order to debug programs using GDB, systemtap or other tools
DEX - improving Debian and its derivatives through cross-community teamwork
Salsa - GitLab-based Debian development server
packages in the NEW queue
LucaFalavigna's checklist for reviewing packages in the NEW queue
Diagrams - this random list of links includes some packaging-related diagrams and sketches
PackageConfigUpgrade - proposed way to smoothly handle configuration upgrades during package upgrades
DataPackages - brainstorming about huge data packages
External links
Regularly updated:
fpm can build .deb packages from various other package formats
Historical:
Managing Debian package files with cme (from 2025)
How to build and deploy a Debian Package with GitLab CI (from 2016)
Debian build tools - Russ's Debian Notes (from 2015)
What's in a debian/ directory (from 2014)
Packaging Scripts for Debian - Russ's Debian Notes (from 2013)
Avoid a newbie packager mistake: don’t build your Debian packages with dpkg -b (from 2010)
Autobuilding non-free packages (from 2006)
Debian Binary Package Building HOWTO (from 2005)
