From WebOS Internals
Jump to navigation Jump to search

Debian 6.0.2 Chroot has been compiled to work with armv6 and armv7 processors, unlike the Ubuntu Chroot that only works with armv7. This means that you can now have a functional linux chroot on your pixi as well.

You need a large-enough ext3fs partition created with Meta-Doctor mounted at /media/ext3fs (instruction how to create partition is available here Chrooting). Note that the latest optware bootstrap package will also use this if it exists. If you have not already done so you should setup the ext3fs partition to mount at bootup. (Failure to do so will cause you to run out of disk space) Instructions can be found on the Meta Doctor page.

  • Using Preware, install Xecutah and Debian 6.0.2 Chroot.
  • Hit the relevant buttons on Xecutah to run the XServer and the Debian 6.0.2 Chroot.
  • Run XServer first, which will open an Xserver window, then return to Xecutah and tap Debian 6.0.2 Chroot. When you return to the Xserver card, you should see a command prompt.
  • Use "apt-get install" to install whatever apps you like from Debian. Then run in the Debian chroot and render on the XServer.

Please support the project with a Donation, and install the Preware Homebrew Documentation app from the official app catalog to learn how to install Preware on your device.


It is possible to use a disk image instead of creating a partition. However, this comes with a few caveats, such as slower speed, disk size restriction (mounting a disk image in cryptofs may limit you to < 2GB) or breaking USB connectivity (on /media/internal). Do this at your own risk. Partitioning with Meta Doctor is the faster and slightly stabler method.

If you do not want to re-doctor your phone, this is how to do it with an image file: First, open a terminal (XServer >XTerm - everything is done on device).

1048576 (KB) means 1 GB, you can replace that (used in two commands). NOTE: You can not create an image file in /media/cryptofs larger than 2GB.

cd /media/cryptofs
dd if=/dev/zero of=debian.img bs=1024 count=1048576
mkfs.ext3 -F -b 1024 debian.img 1048576

mkdir /media/ext3fs

Next, you must mount the new image file.

mount -o loop /media/cryptofs/debian.img /media/ext3fs

To make this mount at boot, you need to add an entry to the fstab:

echo "/media/cryptofs/debian.img /media/ext3fs ext3 loop 0 0" >> /etc/fstab
mount -a

Now you can install Debian 6.0.2 Chroot from Preware and it will populate the image file.

How to remove the ext3fs partition