Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Unofficial repository - PigeBox Project

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 files
Octocat-spinner-32 manifests
Octocat-spinner-32 script
Octocat-spinner-32 .gitignore
Octocat-spinner-32 COPYING
Octocat-spinner-32 COPYRIGHT
Octocat-spinner-32 Changelog
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 TODO
Octocat-spinner-32 config.sample
Octocat-spinner-32 local.rb
Octocat-spinner-32 make-an-usb-image.rdoc


Free continuous recording solution


  • Debian stable system

  • read-only root fs

  • dhcp network configuration

  • zeroconf hostname (avahi)

  • alsa continuous recording daemon (

  • http access (nginx)

  • ssh access


The network configuration is retrieved by dhcp at boot. The zeroconf hostname pigebox.local is published on the network.

The box is reachable via :

The record files are available via :


  • disk storage

  • 15 minutes recording files

  • automatic cleaning of older files

The storage filesystem must have the label pige and be writable for user pige. For example, to create your storage filesystem :

$ ssh root@pigebox.local

# fdisk /dev/sda
# mke2fs -L pige -j /dev/sda1
# mount /srv/pige
# chown pige:audio /srv/pige

The alsa.backup daemon will detect automatically the new mount.



A munin node is started at boot.

Graphs are available on pigebox.local/munin/. These statistics are reset at each reboot.

For persistent statistics, use a external munin manager by adding a node for pigebox.local.


alsa.backup daemon and cron log messages in syslog.

For the moment, it requires an ssh session :

ssh root@pigebox.local tail -f /var/log/syslog


  • iso image

  • disk image


To create quickly a first image :

rake setup pigebox:rebuild

The image can be backup and restored to save bootstrap time :

rake pigebox:bootstrap pigebox:backup
# Then as many times as you need :
rake pigebox:restore pigebox:configure pigebox:dist:iso

To build an iso image :

rake pigebox:dist:iso

To build an disk image :

rake pigebox:dist:disk

You can configure the build with using a config file :

ImageBuilder.default_debian_mirror = "http://localhost:9999/debian"
ImageBuilder.ssh_pubkey = ENV['HOME'] + "/.ssh/"

See +rake -T+ for tasks details :

rake pigebox:backup     # Save the current image directory in tar archive
rake pigebox:bootstrap  # Boostrap debian system in image directory
rake pigebox:clean      # Clean image temporary directory
rake pigebox:configure  # Configure the pigebox image
rake pigebox:dist:iso   # Create an iso file from pigebox image
rake pigebox:dist:disk  # Create a disk image
rake pigebox:restore    # Restore the image directory with existing tar archive
rake setup              # Install some of required tools to create pigebox image


For the moment, an iso image is builded. You can test it with qemu.

Install qemu and its module:

sudo apt-get install qemu kqemu-source
sudo module-assistant a-i kqemu

Create an empty disk:

qemu-img create -f qcow2 /var/tmp/pigebox/disk.img 3G

You will need to initialize the pige storage after first boot (see Storage section).

Create a tap0 network interface:

sudo tunctl -u $USER -t tap0

Start qemu vm:

./script/boot cdrom  # to use iso distribution
./script/boot disk   # to use disk distribution
Something went wrong with that request. Please try again.