Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Bootstrap a Debian system in a file, mostly for deploying to Android.

Project description

This tool uses Multistrap to bootstrap a Debian (or Debian-based) system into an image file as well as adding an Android-targeted launcher script to chroot into the system.


Requirements on the host system:

Requirements on the target device:

  • root access
  • Busybox (this might be pre-installed on your system or you could use one of the various installers on the Play Store)
  • a kernel that supports loop mounts and whatever file system you wish to use

Installation with pip:

# pip3 install android-debian-builder

Installation from the source tarball:

# python3 install


Simply running android-debian-builder (as root) will start building a Debian image in the current directory. To see possible command line options, run android-debian-builder --help. Usually, you’ll want to customise the configuration; the easiest way is to dump the default configuration with android-debian-builder --print-config and build your own based on that.

Additional example configurations are included. These can be found in android_debian_builder/examples in the source distribution or in the examples` subdirectory of the installed package. To include one of these examples in your configuration setup, prefix the file name with ``builtin:examples/ on the command line, like so:

# android-debian-builder --config builtin:examples/jessie-armhf.cfg

Project details

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
android_debian_builder-1.1.0-py3-none-any.whl (36.5 kB) Copy SHA256 hash SHA256 Wheel py3 Mar 5, 2016
android-debian-builder-1.1.0.tar.gz (9.8 kB) Copy SHA256 hash SHA256 Source None Mar 5, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page