Robherc's LinuxOnAndroid/Complete Linux Installer FAQ

Is this the OFFICIAL FAQ for CLI/LinuxOnAndroid?

In short, no. This is not the official FAQ for either the program, or the project. Those FAQs can be found HERE.
This FAQ is one that I (robherc) put together myself to extend the official FAQs, and provide answers to some of the most common questions & issues I've been seeing come up in the linuxonandroid-help IRC channel, and in the [Q&A] Linux-on-Android thread at xda-forums.

Back to Top

How can I tell if I have the most up-to-date version of installed on my device, and why should I care?

To see if you have the most up-to-date version of
  1. Open your Complete Linux Installer app on your device; then click on the "Launch" link, like you're about to open your Linux distribution.

  2. Click to open the "Settings" menu in the top, right corner, then select "Update Scripts"

  3. Check the version number listed for on the following screen. Right now, "V9.0" is the most current version, even though the app will list "V7.8" as current, due to a glitch that should be fixed soon.

Why you should care:
Each new version of that gets released includes updated code to enable the CLI app to smoothly load & run your linux distribution images on more devices, bug fixes to fix problems reported by other users, added functionality, or some combination of those three. In short, if CompleteLinuxInstaller is not correctly loading your Linux dirstribution from a supported image, or if it doesn't have all the functionality you'd like, then the first thing you should do is check to make sure you have the latest inal, in case we've alrready addressed your concern in an updated version. :)

Back to Top

How do I install the most up-to-date version of on my device?

If the "Update Scripts" option described here doesn't automatically update your file to the latest version (currently that's "V9.0"), then follow these directions to upgrade:
  1. Download the latest version releaed by me (robherc) by clicking here.

  2. Copy the file you just downloaded to: /data/data/com.zpwebsites.linuxonandroid/files/ using a ROOTED file manager, such as FX File Manager with root add-on (your file manager will probably ask you to confirm that you want to overwrite the existing file, click yes)

  3. Open your Terminal Emulator app, while your linux distribution is NOT RUNNING and type the following commands:
    cd /data/data/com.zpwebsites.linuxonandroid/files
    ./busybox chmod 0755
  4. This should take you back to your android home screen. Now simply reboot your device & start your Linux distribution through the Complete Linux Installer app as usual.

Back to Top

Where is the best place to get answers to my questions about the Complete Linux Installer app, or about LinuxOnAndroid?

  1. First, check for an answer to your question in this FAQ, or in the official LinuxOnAndroid FAQs.
    These FAQs are your first, best resource. They have been set up to answer the questions you're most likely to have, in an easy-to-find format (also, these FAQs are online pretty much always, but frequently you'll have to wait several hours, to even a couple of days for responses to your questions on IRC, or the forum thread{s}).

  2. If you don't find an answer in either FAQ, then you can check to see if your issue has already been addressed in the xda-developers [Q&A] Linux-on-Android thread.
    I know not all of us have the time, or the inclination, to read through 40+ pages of other people's questions & answers, but please at least browse the most recent 3-5 pages to see if your question was already answered this week ;)

  3. If you're still needing help, and aren't sure that any of the fixes in that thread apply to your situation, then you can post your issue in that thread, or try checking in on our IRC help channel on the freenode IRC server. The channel is #linuxonandroid-help.
    NOTICE: If you happen to immediately catch one of us online and chatting, then the IRC channel can be the fastest way to get an answer (although if it's covered in these FAQs, we'll probably just link you here), please be aware that there are very few developers to answer your questions, and very many hours in the day. If you don't get an answer right away, please don't just ask, wait 5 minutes, then leave; if at all possible, leave your IRC client connected to the channel, then when one of us are available, we can help you with your problem immediately. Alternatively, if you can't keep your IRC client connected, please check the IRC #linuxonandroid-help logs on every few hours, so you can see your answer when one of us come online and reply to you.

  4. If you've tried all of the above, and still cannot get the help you need, then you can read through the full IRC log on, or email

Back to Top

I am getting an error: "chroot: can't execute '/root/': Permission denied" on my android 4.4.x device, what should I do?

This error is becoming common on Samsung devices running android version 4.4.2, and can be expected to happen with some other devices, or newer versions of android. Although I haven't yet found the exact cause of the error, an effective workaround has been found:
  1. The error seems to be coming from something in the busybox executable installed by the Complete Linux Installer app; many have reported that using other versions of busybox removed this problem, and the following version (free download on Google Play) has been confirmed to work: BusyBox
  2. After using that app to install an updated busybox binary, simply copy the new binary over the existing busybox binary at /data/data/com.zpwebsites.linuxonandroid/files/busybox
  3. Finally, in a rooted terminal window, type chmod 0755 /data/data/com.zpwebsites.linuxonandroid/files/busybox (see the more detailed instructions in the How do I install the most up-to-date version of on my device? section of this FAQ)
Now you should be able to start linux using your Complete Linux Installer app on your device.

Back to Top

Copyright 2014
The information contained in this page is released under the terms of the Gnu GPL license v3.0, available at:
All other rights reserved.