Create Signed APT repository
|- in Deutsch||- in English|
|This article is currently under construction. Caution: Article is incomplete and may be incorrect!|
|This article requires some in-depth experience with Dreambox / Linux and is for advanced users.|
After you succeeded in setting up a Dreambox SDK, e.g. for OE 2.2, this article is very interesting. It describes the setup of a signed APT repository. This will allow you to install your own packages via the package manager (APT) of the Dreambox.
Prerequisite for this description is a DEB based ditro (e.g. Ubuntu, Mint, Debian, etc.) which is installed on your computer with your Dreambox SDK. A web server is also needed, to offer the packages for the Dreambox.
sudo apt-get install dpkg-dev apache2 dpkg-sig
Create GPG key
Now we create a GPG key, which will be used to sign the packages and the repository.
The following questions are not described in detail. The standard questions will appear. At the end, enter a passphrase and wait untill the key is generated. Be patient, and meanwhile play a little with the mouse and keyboard ;-).
Display the key
Info about the created key can be displayed with the following command.
Export/save the public key
Now you can create the public key with following commands, the output is stored in a file (e.g.
my_public.key). The key must be copied in the root directory of the web server, and will be loaded by the client Dreamboxes to permit the installation of the packages.
gpg --output keyFile --armor --export your_id_or_name
Setup web server
This example shows the file structure of the web server for a DM 800 HD PVR. While creating the Dreambox SDK the following directories are created:
mips32el. This structure needs to be mirrored in the preconfigured web root of the web server to store the packages:
/var/www/html/repository/dm8000/all /var/www/html/repository/dm8000/dm8000 /var/www/html/repository/dm8000/mip32el
The packages are copied into the corresponding directory.
The packages in the directories can be signed as follows.
dpkg-sig --sign *.deb
Create repository index files
With the following command the required compressed Packages index file can be created. An uncompressed file is also needed.
apt-ftparchive packages . > Packages gzip -c Packages > Packages.gz
Create Release, InRelease, and Release.gpg files
Create Release files.
apt-ftparchive release . > Release gpg --clearsign -o InRelease Release gpg -abs -o Release.gpg Release
Import public key
The public key needs to be imported on the dreambox with the following command. The server IP address and directory must be addapted to your setup.
wget -O - http://server_ip/my_public.key | apt-key add -
Modify package lists
Now you need to create three files for the available feeds (e.g. all, dm8000, mips32el) in the directory
/etc/apt/sources.list. With the following command you can see the content of the files.
root@dm8000:~# cat /etc/apt/sources.list.d/all-feed.list deb http://server_ip/repository/dm8000/all ./ root@dm8000:~# cat /etc/apt/sources.list.d/dm8000-feed.list deb http://server_ip/repository/dm8000/dm8000 ./ root@dm8000:~# cat /etc/apt/sources.list.d/mips32el-feed.list deb http://server_ip/repository/dm8000/mips32el ./ root@dm8000:~#
Update package list / install package
Once everything is configured, it's possible to update the package list on the dreambox:
Now you can install the available packages from the feed.