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 |
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/.
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
| 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 |
![]() Flutter Development |
![]() React Web App |
![]() Jupyter + TensorFlow |
![]() Kotlin/Gradle Build |
![]() GIMP Image Editor |
![]() LibreOffice Writer |
![]() Pitivi Video Editor |
|
| 🌐 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 |
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
| 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 |
- 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
- 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
FluxLinux supports hardware-accelerated graphics:
|
GPU Driver Selection |
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
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
















