https://github.com/erfan2255/debian-on-android

A simple, script to install a full Debian XFCE desktop environment on any Android device using Termux.
https://github.com/erfan2255/debian-on-android

android android-linux debian debian-linux debian-on-android proot-android proot-distro proot-distro-termux termux termux-proot vnc vnc-server

Last synced: 4 days ago
JSON representation

A simple, script to install a full Debian XFCE desktop environment on any Android device using Termux.

• Host: GitHub
• URL: https://github.com/erfan2255/debian-on-android
• Owner: erfan2255
• License: mit
• Created: 2025-08-22T16:31:13.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-08-30T03:35:09.000Z (9 months ago)
• Last Synced: 2025-08-30T05:29:48.033Z (9 months ago)
• Topics: android, android-linux, debian, debian-linux, debian-on-android, proot-android, proot-distro, proot-distro-termux, termux, termux-proot, vnc, vnc-server
• Language: Shell
• Homepage:
• Size: 922 KB
• Stars: 3
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


    

    



    فارسی





    

    
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