FluxLinux

Run full Linux desktops on Android — 12 distros, PRoot or Chroot, XFCE4, X11, and PulseAudio

📱 Screenshots

Home	Distros	Install
Settings	Desktop	Terminal

🐧 Supported Distros

Twelve guests. Every one installs as PRoot (no root) or Chroot (rooted), with XFCE4 on the in-app X11 display and host PulseAudio. Rootfs archives download on demand from the GitHub rootfs tag after an in-app opt-in.

Debian 13 Trixie	Alpine 3.24	Fedora 44	Void Rolling	openSUSE Tumbleweed	Deepin 25
Chimera musl / apk v3	Manjaro ARM	Ubuntu 26.04	Kali Rolling	Parrot 7.2	Arch ARM

Distro	Release	Packages	PRoot	Chroot	XFCE4 + X11	PulseAudio
Debian	13 Trixie	apt	✓	✓	✓	✓
Alpine	3.24	apk	✓	✓	✓	✓
Fedora	44	dnf	✓	✓	✓	✓
Void	Rolling	xbps	✓	✓	✓	✓
openSUSE	Tumbleweed	zypper	✓	✓	✓	✓
Deepin	25	apt	✓	✓	✓	✓
Chimera	Rolling	apk v3	✓	✓	✓	✓
Manjaro	ARM	pacman	✓	✓	✓	✓
Ubuntu	26.04	apt	✓	✓	✓	✓
Kali	Rolling	apt	✓	✓	✓	✓
Parrot	7.2	apt	✓	✓	✓	✓
Arch	ARM	pacman	✓	✓	✓	✓

Debian also ships the optional extra stacks (KDE Plasma, app/web/data/game/office/graphics). The other eleven use the shared XFCE4 + GPU + theme path.

Per-distro notes: docs/distro/.

🚀 Vision

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

✨ Key Features

Feature	Description
🐧 12 Distros	Debian, Alpine, Fedora, Void, openSUSE, Deepin, Chimera, Manjaro, Ubuntu, Kali, Parrot, Arch — each PRoot and Chroot
🖥️ XFCE4 + X11	In-app X11 display (no external Termux:X11). XFCE4 on every guest
🔊 PulseAudio	Host Pulse as the app uid; guests connect over `127.0.0.1` TCP
🔓 Rootless Mode	Works on any Android 8+ device via PRoot
⚡ Turbo Mode	Native chroot for rooted devices (Magisk / KernelSU / APatch BusyBox)
🎮 GPU Acceleration	Turnip (Adreno) + VirGL for graphics
🎨 Custom Themes	XFCE4 Space theme, Papirus icons, wallpapers
📦 Dev Stacks	Extra Debian environments for coding, office, and graphics

🖼️ Desktop Experience

Full XFCE4 desktop with hardware acceleration

🚀 Development in Action

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

Included Development Stacks

🌐 Web Dev Node.js, React, VS Code	📱 App Dev Flutter, Kotlin, Android SDK	🧬 Data Science Jupyter, TensorFlow
🎮 Game Dev Godot Engine	🔐 Security Kali Tools	🎨 Graphics GIMP, Blender

🛠 Architecture

flowchart TB
    subgraph Android["📱 Android Device"]
        FluxLinux["🚀 FluxLinux App<br/>(Kotlin + Jetpack Compose)"]

        subgraph Host["🔧 Embedded host"]
            TermuxHost["bash · proot · PulseAudio"]
            X11["In-app X11 display"]
        end

        subgraph Container["Linux container"]
            PRoot["🔓 PRoot<br/>(rootless)"]
            Chroot["⚡ Chroot<br/>(rooted)"]
        end

        subgraph Distro["🐧 12 guests"]
            XFCE["XFCE4 Desktop"]
            DevTools["Optional Debian stacks"]
        end

        subgraph Display["🖥️ Graphics & audio"]
            GPU["GPU Acceleration<br/>(Turnip / VirGL)"]
            Pulse["Host PulseAudio<br/>TCP 127.0.0.1"]
        end
    end

    FluxLinux --> TermuxHost
    FluxLinux --> X11
    TermuxHost --> PRoot
    TermuxHost --> Chroot
    PRoot --> Distro
    Chroot --> Distro
    Distro --> X11
    X11 --> GPU
    Distro --> Pulse
    TermuxHost --> Pulse

📚 Documentation

Document	Description
Setup & Onboarding Guide	Step-by-step visual installation tutorial
Debian PRoot Setup Guide	Step-by-step Debian PRoot configuration tutorial
Debian Chroot Setup Guide	Step-by-step Debian Chroot configuration tutorial
Distro reference	Per-guest notes (Alpine, Fedora, Ubuntu, Kali, …)
Installation Reference	Packages, paths, versions, environments
Scripts Reference	All installation and setup scripts
Hardware Acceleration	GPU setup guide (Turnip/VirGL)
Script Execution Workflow	How scripts are executed
Testing Reference	Sample projects for testing
Assets Reference	Themes, icons, wallpapers, rootfs
Architecture	System design overview
Roadmap	Development roadmap

📦 Installation

Requirements

Android 8.0+ (API 26+)
No external Termux or Termux:X11 APK — host shell, PRoot, X11, and PulseAudio ship inside FluxLinux
Chroot needs a rooted device with Magisk, KernelSU, or APatch BusyBox

Install

Get FluxLinux from F-Droid, Google Play, or GitHub Releases
Open the app and finish the first-run host setup
Pick a distro and install as PRoot or Chroot — the rootfs downloads after you opt in

Easy setup wizard

🎮 GPU Acceleration

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

🤝 Contributing

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

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

📄 License

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.

Made with ❤️ by Abhay Raj

GitHub • Issues • Documentation • Discord

Get help, share setups, and discuss features