Say you’ve an existing package like
gitg and you want to use the new version of
gitg or even apply your own patches. You could directly
make install but you will probably regret it as soon as you’ll want to upgrade/uninstall, and you want to create a better package than the one created by checkinstall. Apperantly, creating a
deb package for a new version of already packaged
deb isn’t complicated.
Start by pulling the sources for the already available package. I’ll by using
gitg as an example throughout this tutorial.
$ apt-get source gitg
This will create a folder according to the version of the package, something like
gitg-0.2.4. Extract the new version besides it and
cd into its directory. The next step is to copy the
debian/ directory from the old source package the code you’ve just extracted.
$ cp -R ../gitg-0.2.4/debian/ .
There are some dependencies you’ll need:
$ sudo apt-get install devscripts
$ sudo apt-get install dpkg-dev
You’ll probably want to do:
$ sudo apt-get build-dep gitg
in order to make sure you’ve all the relevant build time dependencies.
The next step is to update the files under the
$ DEBEMAIL="Guy Rutenberg <email@example.com>" debchange --nmu
This will update the
debian/changelog and set the new version.
--nmu will create a new “non maintainer upload” version, meaning if the current version was
0.2.4-0ubuntu1, it will change it to
0.2.4-0ubuntu1.1. This will make sure that there won’t be any collision between your package and an official one. If you update to a new upstream version. It might be more suitable to use something like this:
$ debchange --newversion 0.2.5+20111211.git.20391c4
If necessary, update the
Depends sections of
Building the Package
If your building a package directly from version control and not part of an official release, you may need to run
at this point.
Now to the actual building:
$ debuild -us -uc -i -I -b
-us -uc tells the script not to sign the
.changes files accordingly.
-I makes the script ignore common version control files.
debuild to only create binary packages. You can also pass
-j followed by the number of simultaneous jobs you wish to allow (e.g.
-j3, like in
make) which an significantly speed things up.
Installing the Package
The package will reside in the parent directory, for example:
At this point you’re basically done. If you want to install the package you can use
while you’re still inside the build directory.
Creating Source Packages
If you want to go the extra mile and create source packages, it will make things easier for others to build their own packages based on yours.
You’ll need to create a an “orig” tarball
(note the underscore between the package-name and the version). The “orig” tarball should contain the original source-code without the debian specific patches.
Now you can run the
debuild command like before but without the
This will create the following files:
- Man pages for