Run Debian Linux GUI on Android using Termux — fast, stable, and beautifully customized.
Experience the power of a full Debian desktop environment directly on your Android device with Modded Debian by Mahesh Technicals.
This enhanced version comes with preinstalled developer tools, optimized performance, and a modern graphical interface that brings the true Linux experience to mobile.
✅ Audio Fixed – Full sound support in Termux (Proot-Distro)
✅ Lightweight RootFS – Requires only ~4 GB storage
✅ Dual Browser Setup – Chromium + Mozilla Firefox
✅ Bangla Font Support – Perfect for multilingual users
✅ Preinstalled Media Players – VLC & MPV
✅ Code Ready – Visual Studio Code (arm64/aarch64) & Sublime Text
✅ User-Friendly Installer – Designed for beginners
✅ Beautiful UI – Modern icons, wallpapers, and system themes
To get started, you need to install both the Termux app and the Termux:API add-on.
These two applications work together to enable full system functionality and hardware integration.
- 🔗 Termux App (v0.118.3) — Download from GitHub
- 🔗 Termux:API Add-on (v0.53.0) — Download from GitHub
💡 Note: Both apps are officially maintained on GitHub. Avoid downloading from the Google Play Store, as it may contain outdated versions.
apt update && apt upgrade -y
pkg install git wget -y
git clone --depth=1 https://github.com/MaheshTechnicals/Moded-Debian.git
cd Moded-Debian
bash setup.shAfter installation completes, restart Termux and type:
debian
bash user.shEnter your root username (lowercase, no spaces).
Restart Termux again and type:
debian
sudo bash gui.shSet and remember your VNC password.
vnclist # Open the Interactive Menu to choose your Display Server1) TigerVNC (VNC Viewer) Start the server:
vncstart- Install VNC Viewer on your phone.
- Connect to
localhost:1or127.0.0.1:5901
2) NoVNC (Web-Based) Start the server:
webon- Open any web browser on your phone (Chrome, Firefox).
- Go to
http://localhost:6080 - To stop the web server, type
weboff
3) Termux-X11 (Native Android App) Start the server:
x11start- Install the Termux-X11 App (using the nightly build APK from
termux-x11repo). - The script will automatically try to open the display.
- To stop the X11 server, type
x11stop
vncstop # Safely kills all active graphical display servers- Use
debiancommand anytime to enter the Debian CLI. - To easily pick a GUI session:
vnclist - To force stop any and all GUI sessions safely:
vncstop - To remove Debian completely, run:
bash remove.sh
- You must have at least 4 GB free storage before installation.
Watch the setup tutorial below for a complete walkthrough:
See the full list of updates and improvements here:
👉 CHANGELOG.md
- Base Distro: Debian (Proot-Distro)
- Architecture: aarch64 / arm64
- Display Servers: TigerVNC, NoVNC, Termux-X11
- Desktop Environment: XFCE4
- Developed For: Android (Termux)
- Minimum Storage Required: 4 GB free
Q: VNC session not connecting?
A: Restart Termux and type:
debian
vncstartThen reconnect via VNC Viewer.
Q: Audio not working?
A: Run pavucontrol inside Debian GUI and make sure output device is not muted.
Mahesh Varma (Mahesh Technicals)
📧 help@maheshtechnicals.com
🌐 GitHub Profile
This project is licensed under the Apache License.
This project uses Debian images provided by Termux Proot-Distro.
All credits to:
If you like this project, please:
- 🌟 Star the repository
- 🪄 Fork it and make improvements
- 📣 Share it with your friends
“Linux isn’t hard — it’s just a new way to explore your Android!”
debian termux, debian android, linux on android, termux debian setup, vnc viewer termux, moded debian, maheshthechnicals debian, debian xfce termux, proot distro debian, install debian termux gui, debian vnc setup android
If you find this tool helpful and want to support my work, please consider buying me a coffee!
- UPI:
maheshtechnicals@apl
© 2025 Mahesh Technicals — All rights reserved