Skip to content

Repository files navigation

FluxLinux

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

FluxLinux Showcase

Get it on F-Droid Get it on Google Play



Discord Downloads Stars


License Kotlin Latest Release


📱 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
Loading

📚 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

  1. Get FluxLinux from F-Droid, Google Play, or GitHub Releases
  2. Open the app and finish the first-run host setup
  3. 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.

  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

📄 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

GitHubIssuesDocumentationDiscord


Join our Discord

Get help, share setups, and discuss features

About

FluxLinux is Linux on Android, advanced orchestrator application that transforms your Android device into a versatile Linux workstation.

Resources

Stars

206 stars

Watchers

8 watching

Forks

Releases

Packages

Contributors

Languages