Documentation

Complete guide to installing, configuring, and mastering LinuxDroid on your Android device

Quick Start Guide

Get started with LinuxDroid in minutes

Installation Guide

Step-by-step installation instructions

Troubleshooting

Fix common issues and errors

Desktop Environments

Choose your preferred desktop environment

Development Guide

Contribute to LinuxDroid and improve it

Advanced Configuration

Customize and optimize LinuxDroid

Frequently Asked Questions

Find answers to common questions about LinuxDroid

Do I need root access?

No, LinuxDroid does not require root access. It uses a containerized environment that runs within Termux, which doesn't need root privileges.

Which Android version do I need?

LinuxDroid supports Android 5.0 (Lollipop) and above. However, for the best experience, we recommend using Android 7.0 or newer.

How much storage space do I need?

The base installation requires about 2GB of free space. Additional space will be needed for:

  • Desktop environments (500MB - 2GB)
  • Additional packages and applications
  • User data and documents

Can I run GUI applications?

Yes, LinuxDroid supports GUI applications through:

  • VNC Viewer for full desktop environments
  • X11 forwarding for individual applications
  • Native Android display server (experimental)

How do I update LinuxDroid?

To update LinuxDroid, run the following commands:

pkg update && pkg upgrade -y

Can I access Android storage?

Yes, you can access Android storage by:

  1. Running termux-setup-storage
  2. Accessing the shared storage in ~/storage
  3. Using standard Linux file operations

How do I set up audio (ALSA) in LinuxDroid?

To set up ALSA (Advanced Linux Sound Architecture) in LinuxDroid:

  1. Install ALSA utilities:
    2. apt-get update && apt-get install -y alsa-utils pulseaudio
  2. Configure ALSA:
    3. mkdir -p ~/.config/pulse
echo "default-server = 127.0.0.1" > ~/.config/pulse/client.conf
pulseaudio --start
  3. Test audio with:
    4. speaker-test -c2 -t wav

Audio support may vary depending on your Android device and distribution. Some applications may require additional configuration.