Get Started with LinuxDroid

Transform your Android device into a powerful Linux machine in minutes

Download

Install

Configure

Ready

System Requirements

Make sure your device meets these requirements before proceeding

Android Device

Android 5.0 or higher

ARM64 architecture
Root not required

Hardware

Minimum specifications

2GB RAM
2GB free storage

Internet

Connection required

Stable connection
~500MB download

Additional

Optional features

VNC Viewer app
External keyboard

Download Termux

Choose your preferred source to download Termux from the options below.

RECOMMENDED

F-Droid Store

Official source with latest updates and full features

Verified Source Latest Version Auto Updates

Recommended Choice

Download Latest Version

NetHunter Store

Optimized for Kali NetHunter users

Kali Integration Security Tools Regular Updates

Download from NetHunter

Google Play Store

Easy installation through Play Store

Easy Install Auto Updates Limited Features

Download from Play Store

Installation Guide

Follow these steps to set up LinuxDroid on your device

Install Termux

Download and install Termux from F-Droid (recommended)

Open F-Droid and search for "Termux"
Tap Install and grant necessary permissions
Wait for the installation to complete

First time using F-Droid? Follow our quick guide

Install LinuxDroid

Choose one of the installation methods below:

RECOMMENDED

Quick Install (Curl)

One-line installation with curl (fastest method)

termux-setup-storage && pkg update -y && curl -sSL https://raw.githubusercontent.com/AryanVBW/LinuxDroid/refs/heads/main/1click.install.sh | bash

Manual Install (Wget)

Step-by-step installation with wget

pkg update -y && pkg upgrade -y
termux-setup-storage
pkg install wget -y && pkg install figlet -y 
wget https://github.com/AryanVBW/LinuxDroid/releases/download/scripts/LinuxDroidmenu.sh && chmod +x LinuxDroidmenu.sh
wget https://github.com/AryanVBW/LinuxDroid/releases/download/A1/default.bashrc && chmod +x default.bashrc
rm -rf .bashrc && cp default.bashrc .bashrc
wget https://github.com/AryanVBW/LinuxDroid/releases/download/scripts/LinuxDroid.sh && chmod +x LinuxDroid.sh && bash LinuxDroid.sh

Both methods include the necessary setup steps. The curl method is faster, while the wget method gives you more control.

Choose Your Distribution

Select and configure your preferred Linux distribution

Popular

Ubuntu

Beginner Friendly Development

Security

Kali Linux

Penetration Testing Security Tools

Stable

Debian

Lightweight Server

Distribution Comparison

Ubuntu

General Use, Development

~1.5 GB

Kali Linux

Security, Penetration Testing

~2.0 GB

Debian

Servers, Lightweight Systems

~1.0 GB

Arch Linux

Customization, Lightweight, Advanced Users

~0.8 GB

Manjaro

User-friendly Arch-based, Beginner Advanced

~1.2 GB

Fedora

Cutting-edge, Development, Workstation

~1.7 GB

Alpine

Security-oriented, Minimal, Containers

~0.3 GB

Void Linux

Independent, Rolling Release, runit init

~0.7 GB

Ubuntu 22.04

LTS, Stability, General Use

~1.6 GB

Ubuntu 20.04

Older LTS, Compatibility, Stability

~1.5 GB

After installation, you can switch between distributions or install additional ones using the LinuxDroid menu.

Advanced Installation

Advanced configuration options and custom installations

Desktop Environments

LXDE

Lightweight X11 Desktop Environment

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/refs/heads/main/APT/LXDE/lxde_de.sh && bash lxde_de.sh

LXQT

Modern and lightweight Qt desktop

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/refs/heads/main/APT/LXQT/lxqt_de.sh && bash lxqt_de.sh

XFCE

Fast and lightweight desktop environment

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/refs/heads/main/APT/XFCE4/xfce4_de.sh && bash xfce4_de.sh

Window Managers

Lightweight window managers (i3, Awesome, etc.)

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/refs/heads/main/WM/APT/i3.sh && bash i3.sh

Desktop environments can be installed after the base system installation. Make sure to install the base system first.

Custom Configuration

Additional configuration scripts and utilities:

VNC Configuration

Configure VNC server for graphical access:

vncserver-start    # Start VNC server
vncserver-stop     # Stop VNC server

Package Management

Basic package management commands:

apt update         # Update package lists
apt upgrade        # Upgrade packages
pacman -Syu       # Update & upgrade (Arch)
apk update        # Update packages (Alpine)

Installation Options

Choose your preferred Linux distribution and installation type

Select an OS below to view available installation options. For graphical environments, you'll need a VNC viewer app to access the interface.

Kali CLI

Command-line interface with essential security tools

pkg update -y && pkg install wget curl proot tar -y && wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/Cli/kali.sh -O kali-cli.sh && chmod +x kali-cli.sh && bash kali-cli.sh

Kali XFCE

Full graphical environment with XFCE desktop

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/GUI%20XFCE/kali-xfce.sh && chmod +x kali-xfce.sh && bash kali-xfce.sh

Kali LXDE

Lightweight desktop environment for Kali

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Kali/kali-lxde.sh && chmod +x kali-lxde.sh && bash kali-lxde.sh

Kali LXQT

Modern Qt-based lightweight desktop for Kali

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Kali/kali-lxqt.sh && chmod +x kali-lxqt.sh && bash kali-lxqt.sh

Uninstall Kali

Remove Kali Linux installation

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Uninstall/Kali/UNI-kali.sh && chmod +x UNI-kali.sh && bash UNI-kali.sh

Kali NetHunter

Mobile penetration testing platform based on Kali Linux

wget -O install-nethunter-termux https://offs.ec/2MceZWr && chmod +x install-nethunter-termux && ./install-nethunter-termux

Ubuntu 22.04 CLI

Command-line interface with essential tools

pkg update -y && pkg install wget curl proot tar -y && wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/Cli/ubuntu22.sh -O ubuntu22.sh && chmod +x ubuntu22.sh && bash ubuntu22.sh

Ubuntu XFCE

Full graphical environment with XFCE desktop

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/GUI%20XFCE/ubuntu-xfce.sh && chmod +x ubuntu-xfce.sh && bash ubuntu-xfce.sh

Ubuntu LXDE

Lightweight desktop environment for Ubuntu

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Ubuntu/ubuntu-lxde.sh && chmod +x ubuntu-lxde.sh && bash ubuntu-lxde.sh

Ubuntu LXQT

Modern Qt-based lightweight desktop for Ubuntu

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Ubuntu/ubuntu-lxqt.sh && chmod +x ubuntu-lxqt.sh && bash ubuntu-lxqt.sh

Ubuntu i3

Tiling window manager for advanced users

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Ubuntu/ubuntu-i3.sh && chmod +x ubuntu-i3.sh && bash ubuntu-i3.sh

Ubuntu Awesome

Highly configurable window manager

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Ubuntu/ubuntu-awesome.sh && chmod +x ubuntu-awesome.sh && bash ubuntu-awesome.sh

Uninstall Ubuntu

Remove Ubuntu Linux installation

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Uninstall/Ubuntu/UNI-ubuntu.sh && chmod +x UNI-ubuntu.sh && bash UNI-ubuntu.sh

Ubuntu 20.04 CLI

Previous LTS version with command-line interface

pkg update -y && pkg install wget curl proot tar -y && wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/Cli/ubuntu20.sh -O ubuntu20.sh && chmod +x ubuntu20.sh && bash ubuntu20.sh

Arch CLI

Lightweight command-line interface

pkg update -y && pkg install wget curl proot tar -y && wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/Cli/arch.sh -O arch.sh && chmod +x arch.sh && bash arch.sh

Arch XFCE

Full graphical environment with XFCE desktop

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/GUI%20XFCE/arch-xfce.sh && chmod +x arch-xfce.sh && bash arch-xfce.sh

Arch LXDE

Ultra lightweight desktop environment for Arch

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Arch/amd64/arch-lxde.sh && chmod +x arch-lxde.sh && bash arch-lxde.sh

Uninstall Arch

Remove Arch Linux installation

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Uninstall/Arch/UNI-arch.sh && chmod +x UNI-arch.sh && bash UNI-arch.sh

Debian CLI

Stable command-line interface

pkg update -y && pkg install wget curl proot tar -y && wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/Cli/debian.sh -O debian.sh && chmod +x debian.sh && bash debian.sh

Debian XFCE

Full graphical environment with XFCE desktop

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/GUI%20XFCE/debian-xfce.sh && chmod +x debian-xfce.sh && bash debian-xfce.sh

Debian LXDE

Lightweight desktop environment for Debian

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Debian/debian-lxde.sh && chmod +x debian-lxde.sh && bash debian-lxde.sh

Debian LXQT

Modern Qt-based lightweight desktop for Debian

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Debian/debian-lxqt.sh && chmod +x debian-lxqt.sh && bash debian-lxqt.sh

Debian i3

Tiling window manager for advanced users

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Installer/Debian/debian-i3.sh && chmod +x debian-i3.sh && bash debian-i3.sh

Uninstall Debian

Remove Debian Linux installation

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Uninstall/Debian/UNI-debian.sh && chmod +x UNI-debian.sh && bash UNI-debian.sh

Parrot CLI

Security-focused command-line interface

pkg update -y && pkg install wget curl proot tar -y && wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/Cli/parrot.sh -O parrot.sh && chmod +x parrot.sh && bash parrot.sh

Parrot XFCE

Full graphical environment with XFCE desktop

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/InstallScript/GUI%20XFCE/parrot-xfce.sh && chmod +x parrot-xfce.sh && bash parrot-xfce.sh

Uninstall Parrot

Remove Parrot OS installation

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Uninstall/Parrot/UNI-parrot.sh && chmod +x UNI-parrot.sh && bash UNI-parrot.sh

Uninstallation

Remove installed Linux distributions when no longer needed

Important: Each OS tab in the Installation Options section above includes an uninstall option (highlighted with a caution label) that you can use to completely remove the distribution when no longer needed. Make sure to backup any important data before uninstalling.

Additional User Scripts

Useful scripts to enhance your LinuxDroid experience

LinuxDroid Menu

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/LinuxDroidmenu.sh && chmod +x LinuxDroidmenu.sh && bash LinuxDroidmenu.sh

Install Menu

wget https://raw.githubusercontent.com/AryanVBW/LinuxDroid/main/Scripts/installMenu.sh && chmod +x installMenu.sh && bash installMenu.sh

Troubleshooting Guide

Common issues and their solutions

Installation Script Fails

Try these steps in order:

Update Termux packages:
```
pkg update && pkg upgrade -y
```
Clear Termux data and try again
Check internet connection

Storage Access Denied

Grant storage permissions:

termux-setup-storage

If the issue persists:

Check app permissions in Android Settings
Reinstall Termux if needed

GUI Not Working

Verify VNC installation:

vncserver -list

Common solutions:

Install a VNC viewer app
Check port forwarding
Verify desktop environment installation

Need More Help?

Join our community for support:

GitHub Issues