فارسی

Debian 13 on Android

Turn your Android device into a portable Linux PC

A simple, one-line command to install a full Debian (XFCE) desktop environment on any Android device using Termux

---

► Purpose

The goal of this project is to provide a seamless and fully automated way for users to get a powerful, feature-rich Debian desktop experience on their Android device without needing root access. It's designed for developers, students, and Linux enthusiasts who want a portable and persistent computing environment.

---

► Features

• 🚀 Fully Automated: The script handles everything from initial setup to user creation and software installation.
• 🖥️ Full Desktop Environment: Installs the lightweight and user-friendly XFCE desktop.
• 📚 Essential Software: Comes pre-loaded with Firefox ESR for web browsing and the complete LibreOffice suite for productivity.
• ✨ User-Friendly: Interactive prompts for username, password, and VNC screen resolution.
• ⚡ Convenient Aliases: Includes simple shortcuts for easy management.

---

► Requirements

• An Android device (phone or tablet).
• The Termux app installed.
• A VNC Viewer app (e.g., RealVNC, AVNC) installed on your Android device.
• Approximately 4-5 GB of free storage space.

---

► Installation & Usage

1. Run the Installer

Paste the one-line command below into your Termux terminal and press Enter.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/erfan2255/debian-on-android/main/setup.sh)"

2. Follow the Prompts

The script will guide you through creating a username and password for your new Debian system.

3. Log In

After the installation is complete, a debian alias will be created in Termux. To log in, simply type:

debian

4. Start the VNC Server

Once you are logged into your Debian environment, start the graphical desktop by typing:

startvnc

The first time you run this, you will be asked to select a screen resolution and set a VNC-specific password.

5. Connect with a VNC Client

Open your VNC Viewer app and create a new connection to the following address:

localhost:1

Enter the VNC password you created in the previous step. You will now see your Debian desktop!

6. Stop the VNC Server

When you are finished with your session, you can stop the VNC server from inside Debian by typing:

stopvnc

---

► What's Included?

Component	Description
Operating System	Debian 13 (Trixie)
Desktop Environment	XFCE 4
Web Browser	Firefox ESR
Office Suite	LibreOffice (Writer, Calc, Impress, etc.)
VNC Server	TigerVNC
System Utilities	sudo, nano, adduser, and more.

---

► Screenshots

Here is a preview of the Debian 13 XFCE desktop environment you will be installing.

Debian info

Libre Office

---

► Show Your Support

If you find this project useful, please give it a ⭐ to show your support!

► License

This project is licensed under the MIT License. See the LICENSE file for details.

---

by CoreLand