Setting Up A System For Packaging
VM or install?
In this walkthrough we will be explaining certain things that are only on a VM. It is your choice if you want to install a full Kali system (or if you already have one, if you want to use it) or if you want to use a VM, however keep in mind what commands you’re entering if it is an install.
Setting up the VM
It’s important to set up a development environment. The easiest way to go about this is to set up a VM with the latest Kali image and give it a large filesystem. 80GB+ is good for a few packages at a time, however 150GB+ is recommended if you are using
mr to download all packaging repositories. Likely, you will not need all of the packages to be downloaded.
We will install tools that we will use later for packaging.
packaging-dev is a metapackage, and will install many of the proper packages that are needed.
kali@kali:~$ sudo apt install -y packaging-dev apt-file gitk mr ... kali@kali:~$
User accounts and keys
Packaging needs to be done on a non-root user with sudo privileges. The default Kali user is suitable for this.
you must log out of your account and switch to the new user (rather than using
su). This is done as some pieces (such as variables that are set) of the following setup require you to be on that account,
su will not work.
Next, we should generate SSH and GPG keys. These are important for packaging as they will allow us to access our files on GitLab easily and ensure the work is ours. This step is not always necessary, however it is helpful in certain cases. You will know if you need to set up a GPG key, however we recommend setting up an SSH key as it will make the packaging process quicker.
kali@kali:~$ ssh-keygen -t rsa kali@kali:~$ kali@kali:~$ gpg --gen-key gpg (GnuPG) 1.4.12; Copyright (C) 2012 Free Software Foundation, Inc. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. gpg: directory `/home/packaging/.gnupg' created gpg: new configuration file `/home/packaging/.gnupg/gpg.conf' created gpg: WARNING: options in `/home/packaging/.gnupg/gpg.conf' are not yet active during this run gpg: keyring `/home/packaging/.gnupg/secring.gpg' created gpg: keyring `/home/packaging/.gnupg/pubring.gpg' created Please select what kind of key you want: (1) RSA and RSA (default) (2) DSA and Elgamal (3) DSA (sign only) (4) RSA (sign only) Your selection? 1 RSA keys may be between 1024 and 4096 bits long. What keysize do you want? (2048) Requested keysize is 2048 bits Please specify how long the key should be valid. 0 = key does not expire <n> = key expires in n days <n>w = key expires in n weeks <n>m = key expires in n months <n>y = key expires in n years Key is valid for? (0) Key does not expire at all Is this correct? (y/N) y You need a user ID to identify your key; the software constructs the user ID from the Real Name, Comment and Email Address in this form: "Heinrich Heine (Der Dichter) <firstname.lastname@example.org>" Real name: First Last Email address: email@example.com Comment: You selected this USER-ID: "First Last <firstname.lastname@example.org>" Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? O You need a Passphrase to protect your secret key. We need to generate a lot of random bytes. It is a good idea to perform some other action (type on the keyboard, move the mouse, utilize the disks) during the prime generation; this gives the random number generator a better chance to gain enough entropy. Not enough random bytes available. Please do some other work to give the OS a chance to collect more entropy! (Need 284 more bytes) gpg: /home/packaging/.gnupg/trustdb.gpg: trustdb created gpg: key A123BC4D marked as ultimately trusted public and secret key created and signed. gpg: checking the trustdb gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u pub 2048R/1234AB5C 2000-00-00 Key fingerprint = 12AB 34C4 67DE F890 12G3 H45I 6789 J90K L123 MN4O uid First Last <email@example.com> sub 2048R/12345A6B 2000-00-00 kali@kali:~$
Please remember to change “First Last firstname.lastname@example.org” to be your name and email.
The next step is to add the SSH key to your GitLab account. This can be done in the keys section. Run the commands below to put the key in the copy-paste buffer and paste it on GitLab’s web page.
kali@kali:~$ sudo apt install -y xclip kali@kali:~$ kali@kali:~$ cat ~/.ssh/id_rsa.pub | xclip kali@kali:~$
Setting up files
We now need to set up git-buildpackage/
kali@kali:~$ cat <<EOF> ~/.gbp.conf [DEFAULT] pristine-tar = True cleaner = /bin/true [buildpackage] sign-tags = True export-dir = $HOME/kali/build-area/ ignore-branch = True ignore-new = True [import-orig] filter-pristine-tar = True [pq] patch-numbers = False [dch] multimaint-merge = True ignore-branch = True EOF kali@kali:~$ kali@kali:~$ grep -q DEBEMAIL ~/.bashrc \ || echo export DEBEMAILemail@example.com >> ~/.bashrc kali@kali:~$
Be sure to replace
firstname.lastname@example.org with your email, and ensure it is the same one used with your GPG key, if that was setup.
pristine-tar by default as we will use this tool to (efficiently) store a copy of the upstream tarball in the Git repository. We also set
export-dir so that package builds happen outside of the git checkout directory.
Below, we’re customizing some useful tools provided by the
kali@kali:~$ gpg -k pub rsa2048 2019-01-01 [SC] [expires: 2021-12-21] ABC123DE45678F90123G4567HIJK890LM12345N6 uid [ultimate] First Last <email@example.com> sub rsa2048 2019-01-01 [E] [expires: 2021-12-21] kali@kali:~$ kali@kali:~$ cat <<EOF> ~/.devscripts DEBRELEASE_UPLOADER=dput DEBRELEASE_DEBS_DIR=$HOME/kali/build-area/ DEBCHANGE_RELEASE_HEURISTIC=changelog DEBCHANGE_MULTIMAINT_MERGE=yes DEBCHANGE_PRESERVE=yes DEBUILD_LINTIAN_OPTS="--color always -I" DEBCHANGE_AUTO_NMU=no DEBSIGN_KEYID=ABC123DE45678F90123G4567HIJK890LM12345N6 EOF kali@kali:~$
Be sure to put your own key id in
DEBSIGN_KEYID. In this example we can see from
gpg - k that our key is
You may also want to add the following to your git config:
kali@kali:~$ gpg -k pub 2048R/A123BC4D 2012-12-07 uid First Last <firstname.lastname@example.org> sub 2048R/12345A6B 2012-12-07 kali@kali:~$ kali@kali:~$ git config --global user.name "First Last" kali@kali:~$ kali@kali:~$ git config --global user.email email@example.com kali@kali:~$
user.email must match your gpg key details (
gpg -k) or you will get a “Secret Key Not Available” error later on:
We also want to enable a new git merge driver:
kali@kali:~$ cat <<EOF >> ~/.gitconfig [merge "dpkg-mergechangelogs"] name = debian/changelog merge driver driver = dpkg-mergechangelogs -m %O %A %B %A EOF kali@kali:~$
We also will need to set up sbuild. Although this isn’t too difficult, it does require some extra setup.
kali@kali:~$ sudo mkdir -p /srv/chroots/ kali@kali:~$ kali@kali:~$ cd /srv/chroots/ kali@kali:/srv/chroots$ sudo sbuild-createchroot --keyring=/usr/share/keyrings/kali-archive-keyring.gpg --arch=amd64 --components=main,contrib,non-free --include=kali-archive-keyring kali-dev kali-dev-amd64-sbuild http://http.kali.org/kali kali@kali:/srv/chroots$
Once that is done, we need to edit
/etc/schroot/chroot.d/kali-dev-amd64-sbuild*, note that “*” is used as it will generate the last bit randomly. Alternatively, use TAB auto-completion.
kali@kali:~$ echo "source-root-groups=root,sbuild" | sudo tee -a /etc/schroot/chroot.d/kali-dev-amd64-sbuild* kali@kali:~$ kali@kali:~$ cat /etc/schroot/chroot.d/kali-dev-amd64-sbuild* [kali-dev-amd64-sbuild] description=Debian kali-dev/amd64 autobuilder groups=root,sbuild root-groups=root,sbuild profile=sbuild type=directory directory=/srv/chroots/kali-dev-amd64-sbuild union-type=overlay source-root-groups=root,sbuild kali@kali:~$
Finally, we just need to add our user to the group and do one last change.
kali@kali:~$ sudo sbuild-adduser $USER kali@kali:~$ kali@kali:~$ cat <<EOF> ~/.sbuildrc \$build_arch_all = 1; \$build_source = 1; \$run_lintian = 1;\ \$lintian_opts = ['-I']; EOF kali@kali:~$
When building a package with a sbuild, a lot of time (and bandwidth) is spent downloading the build dependencies. To speed up this step, it’s possible to use a caching proxy, such as apt-cacher-ng.
kali@kali:~$ sudo apt install -y apt-cacher-ng
Check the version that was installed. If it’s below
0.6.1-1, Kali is not supported out of the box, and there’s a little config to do:
kali@kali:~$ echo "http://http.kali.org/kali/" | sudo tee /etc/apt-cacher-ng/kali_mirrors kali@kali:~$ kali@kali:~$ echo "http://kali.download/kali/" | sudo tee /etc/apt-cacher-ng/backends_kali kali@kali:~$ kali@kali:~$ cat <<EOF | sudo tee /etc/apt-cacher-ng/kali.conf # Repository remapping for Kali. See acng.conf and manual for details. Remap-klxrep: file:kali_mirrors /kali ; file:backends_kali EOF kali@kali:~$ kali@kali:~$ sudo systemctl enable apt-cacher-ng --now kali@kali:~$
In the snippet above, note that:
- the file
kali_mirrorslists all the mirrors for which apt-cacher-ng will cache the requests. In this list, there should be at least the mirror that you used with the command
- the file
backends_kalilists the mirror that apt-cacher-ng will actually use to download packages. You should set it to a mirror that is close to you.
Finally, we just need to add a line of configuration inside our chroot, so that apt is configured to use the proxy.
kali@kali:~$ sudo sbuild-shell source:kali-dev-amd64-sbuild I: /bin/sh # echo 'Acquire::HTTP::Proxy "http://localhost:3142";' > /etc/apt/apt.conf.d/01proxy # exit kali@kali:~$
In order to make sure that everything works, there’s a few things you can do:
tail -f /var/log/apt-cacher-ng/apt-cacher.logwhile you run build a package with sbuild.
- check that the directory
/var/cache/apt-cacher-ng/klxrep/is being populated with packages.
Updated on: 2021-Jun-22