The fastest easiest way to get it right.

Building Our Debian Package


The following packages are required when *BUILDING* the debian package. These are not needed when you are installing andromeda from the debian package.

  • debhelper
  • fakeroot

All of the following files go into the folder named "debian" inside the root source directory. Every file listed is necessary for the build process.


The control file is where you control the package dependencies. There are two sets of configurations in this file: Source and Package. Source sets the dependencies for the build process while Package sets the dependencies for installing the debian package. Most of the labels in the file are self explanatory. The following is an example of a control file with the correct syntax:

Source: andromeda
Section: unknown
Priority: extra
Maintainer: Josh Belanich 
Build-Depends: debhelper (>= 5)
Standards-Version: 3.7.2

Package: andromeda
Architecture: all
Depends: ${shlibs:Depends}, ${misc:Depends}, php5, php5-pgsql, php-pear, postgresql-8.3, perl, postgresql-plperl-8.3, libnet-smtp-server-perl, postgresql-contrib, debconf
Recommends: pgadmin3, subversion
Description: "Up to 60 characters description"
 "Long description indented with spaces."


The copyright file holds all of the copyright information for the package and other information such as authors and the license. The following is an example of a copyright file with the correct syntax:

This package was debianized by Josh Belanich on
Fri, 18 Jul 2008 15:37:26 -0400.

It was downloaded from url://

Upstream Author(s): 

    put author's name and email here
    likewise for another author


    Copyright (C) YYYY Name OfAuthor
    likewise for another author


    "GPL License Here"

The Debian packaging is (C) 2008, Josh Belanich  and
is licensed under the GPL, see `/usr/share/common-licenses/GPL'.


The install file describes the directory structure of the package and where the different folders and file types will be installed. Here you can use wildcards in the names of files and folders. It is important to specify where the filetypes in the base folder go, because they aren't part of any other folder and will not be moved along with those folders. You do not need to specify where the files inside the other folders go however, because they will follow with the folders. The following is an example install file:

*.php		/var/www/andro_root/andro
*.sql		/var/www/andro_root/andro

appclib		/var/www/andro_root/andro
application	/var/www/andro_root/andro
apppub		/var/www/andro_root/andro
clib		/var/www/andro_root/andro
docsapp		/var/www/andro_root/andro
docslib		/var/www/andro_root/andro
dynamic		/var/www/andro_root/andro
generated	/var/www/andro_root/andro
lib		/var/www/andro_root/andro
root		/var/www/andro_root/andro
templates	/var/www/andro_root/andro
tmp		/var/www/andro_root/andro


The rules file lists the procedure of the building process. The rules file is unimportant in our debian package mostly because we do not require any compilations like c or c++. If you need to change the package, you should not have to change the rules file. Debhelper was used to build the basic structure of the rules file that was needed. Debhelper is a dependency for building this debian package.


The changelog file is where you list all of the major changes and bug fixes from one version of andromeda to another. The following is an example changelog file with the correct syntax:

andromeda (0.1.0) stable; urgency=low

  * Initial release (Closes: #nnnn)  (nnnn is the bug number of your ITP)

 -- Josh   Fri, 18 Jul 2008 15:37:26 -0400

installation and removal scripts

These bash scripts execute at different stages of the installation process of a debian package. postinst and postrm run after the package install and after the removal, respectively. preinst and prerm run before the package install and before the removal, respectively. These are ordinary bash scripts that you build in order to set up the correct environment for the program.

Running the Package Build

If all of the above files are inside the debian directory inside your root source directory and have installed all of the build dependencies, then you are ready to build the package. Run the following command in your root source directory:

sudo dpkg-buildpackage -us -uc -rfakeroot -b

This command will build the package and place the .deb file one directory down from the root source directory. Here you will find a few other files that are generated by the packaging system.

comments powered by Disqus
Home |  Documentation |  Download |  Credits |  Contact |  Login
Andromeda © Copyright 2004-2013, Licensed under the GPL Version 2