FluxLinux

Run full Linux desktop environments on your Android device

Home	Distros	Install
Settings	Desktop	Terminal

FluxLinux Setup	New to FluxLinux? Check out our comprehensive Step-by-Step Installation & Onboarding Guide for a detailed visual walkthrough covering both rooted and non-rooted devices.
Debian Trixie PRoot	Debian Setup Guide (Rootless): Follow our Debian PRoot Configuration Guide for a detailed visual walkthrough of setting up your first Debian container without root access.
Debian Trixie Chroot	Debian Setup Guide (Rooted): Follow our Debian Chroot Configuration Guide for setting up a native, high-performance Debian container using root access.

Complete FluxLinux Setup Guide

Modern Android hardware is powerful enough to run desktop workloads, but the software ecosystem limits it. FluxLinux bridges this gap, enabling:

• 🌐 Full-Stack Web Development — Node.js, Python, React, VS Code
• 🎮 Desktop Gaming — Box64/Wine (coming soon)
• 🔐 Cybersecurity — Nmap, Wireshark, Metasploit
• 📊 Data Science — Jupyter, TensorFlow, PyTorch
• 🎨 Creative Tools — GIMP, Blender, Inkscape
• 📄 Productivity — LibreOffice, Firefox Desktop

Full XFCE4 desktop with hardware acceleration

Flutter Development	React Web App
Jupyter + TensorFlow	Kotlin/Gradle Build
GIMP Image Editor	LibreOffice Writer
Pitivi Video Editor

flowchart TB
    subgraph Android["📱 Android Device"]
        FluxLinux["🚀 FluxLinux App<br/>(Kotlin + Jetpack Compose)"]
        
        subgraph Termux["🔧 Termux Environment"]
            TermuxHost["Terminal Host"]
            
            subgraph Container["Linux Container"]
                PRoot["🔓 PRoot<br/>(Rootless)"]
                Chroot["⚡ Chroot<br/>(Rooted)"]
            end
            
            subgraph Distro["🐧 Debian 13 Trixie"]
                XFCE["XFCE4 Desktop"]
                DevTools["Development Tools"]
            end
        end
        
        subgraph Display["🖥️ Display System"]
            X11["Termux:X11"]
            GPU["GPU Acceleration<br/>(Turnip/VirGL)"]
        end
    end
    
    FluxLinux --> TermuxHost
    TermuxHost --> PRoot
    TermuxHost --> Chroot
    PRoot --> Distro
    Chroot --> Distro
    Distro --> X11
    X11 --> GPU

• Android 8.0+ (API 26+)
• Termux (from F-Droid)
• Termux:X11 (for GUI)

1. Download FluxLinux from Releases
2. Install Termux from F-Droid
3. Install Termux:X11
4. Open FluxLinux and follow setup wizard

Easy setup wizard

FluxLinux supports hardware-accelerated graphics:

GPU Type Driver Performance Adreno (Qualcomm) Turnip + Zink 🟢 Excellent Mali (ARM) VirGL 🟡 Good Mali/PowerVR (MediaTek) VirGL 🟡 Good Other VirGL 🟡 Good 📖 Hardware Acceleration Guide

GPU Driver Selection

Contributions are welcome! Please check the Roadmap to see active development phases.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the GNU General Public License v3.0 (GPLv3).

See LICENSE for details.

Embedded components: The in-app terminal stack bundles termux-app v0.118.0 (GPLv3) for TerminalSession/TerminalView; host userland packages are rebuilt from the Termux package repo (native/). FluxLinux remains open source under GPLv3, consistent with these dependencies.

Get help, share setups, and discuss features