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

🖼️ 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

🛠 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

📦 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.

Get help, share setups, and discuss features

What's Changed

Features

• Terminal starts faster; PRoot sessions launch directly (no proot-distro Python), chroot prep runs off the UI thread
• Shared storage access in guests (all-files access) and a new onboarding page (#48, #29)
• Disable the Android phantom-process killer via Shizuku, root or adb (#41)
• Auto-install Mesa Turnip on Adreno and PanVK on MediaTek Mali v10+ (with fallback and retry)
• KDE runs on the built-in X11 server; compositing and effects off by default; opt-in zink GL on Turnip/PanVK
• One-time notice that v1.x Termux distros were not removed on upgrade (#37)

Bug Fixes

• Crash on foreground-service notifications (monochrome small icon) (#42, #46)
• Chromium/Electron typing in X11 (#45)
• Host env and paths refresh after an app update and on app start
• Desktop waits for the X socket; stale running-desktop state is cleared
• KDE on PanVK no longer exhausts RAM
• UI contrast in dark/light themes, unified top bars, correct GPU tag in the distro picker

Build / F-Droid

• All native code (host packages, loader.apk, guest helpers, terminal-emulator, libXlorie) is built from source without Docker
• All native libraries are 16 KB page aligned
• Reproducible release: the APK is built from the tagged commit with the F-Droid recipe (com.ivarna.fluxlinux.yml) and signed with the release key