{"id":30592418,"url":"https://github.com/erfan2255/debian-on-android","last_synced_at":"2026-05-09T06:02:32.251Z","repository":{"id":311197350,"uuid":"1042825712","full_name":"erfan2255/debian-on-android","owner":"erfan2255","description":"A simple, script to install a full Debian XFCE desktop environment on any Android device using Termux.","archived":false,"fork":false,"pushed_at":"2025-08-30T03:35:09.000Z","size":944,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-30T05:29:48.033Z","etag":null,"topics":["android","android-linux","debian","debian-linux","debian-on-android","proot-android","proot-distro","proot-distro-termux","termux","termux-proot","vnc","vnc-server"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/erfan2255.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-22T16:31:13.000Z","updated_at":"2025-08-30T03:35:12.000Z","dependencies_parsed_at":"2025-08-22T19:46:33.092Z","dependency_job_id":"f98634cb-ccd4-4a53-ae55-f877b35f6b04","html_url":"https://github.com/erfan2255/debian-on-android","commit_stats":null,"previous_names":["erfan2255/debian-on-android"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/erfan2255/debian-on-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erfan2255%2Fdebian-on-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erfan2255%2Fdebian-on-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erfan2255%2Fdebian-on-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erfan2255%2Fdebian-on-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erfan2255","download_url":"https://codeload.github.com/erfan2255/debian-on-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erfan2255%2Fdebian-on-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32809147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-linux","debian","debian-linux","debian-on-android","proot-android","proot-distro","proot-distro-termux","termux","termux-proot","vnc","vnc-server"],"created_at":"2025-08-29T18:00:58.105Z","updated_at":"2026-05-09T06:02:32.246Z","avatar_url":"https://github.com/erfan2255.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!DOCTYPE html\u003e\n\u003chtml lang=\"en\"\u003e\n\u003chead\u003e\n    \u003cmeta charset=\"UTF-8\"\u003e\n    \u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"\u003e\n\u003c/head\u003e\n\u003cbody\u003e\n\n\u003cdiv align=\"right\"\u003e\n    \u003ca href=\"README-FA.md\"\u003eفارسی\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/erfan2255/debian-on-android/blob/main/Images/Openlogo-debianV2.svg\" alt=\"Debian Logo\" width=\"100\"/\u003e\n    \u003ch1\u003eDebian 13 on Android\u003c/h1\u003e\n    \u003ch3\u003eTurn your Android device into a portable Linux PC\u003c/h3\u003e\n    \u003cp\u003eA simple, one-line command to install a full Debian (XFCE) desktop environment on any Android device using Termux\u003c/p\u003e\n    \u003cp\u003e\n        \u003cimg src=\"https://img.shields.io/github/license/erfan2255/Debian-On-Android?style=square\" alt=\"License\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/last-commit/erfan2255/Debian-On-Android?style=square\" alt=\"Last Commit\"\u003e\n        \u003ca href=\"https://opensource.org\"\u003e\u003cimg src=\"https://badges.frapsoft.com/os/v1/open-source.svg?v=103\" alt=\"Open Source\"\u003e\u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e\n\n\u003chr\u003e\n\n\u003ch3\u003e► Purpose\u003c/h3\u003e\n\u003cp\u003eThe 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.\u003c/p\u003e\n\n\u003chr\u003e\n\n\u003ch3\u003e► Features\u003c/h3\u003e\n\u003cul\u003e\n    \u003cli\u003e\u003cstrong\u003e🚀 Fully Automated:\u003c/strong\u003e The script handles everything from initial setup to user creation and software installation.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003e🖥️ Full Desktop Environment:\u003c/strong\u003e Installs the lightweight and user-friendly XFCE desktop.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003e📚 Essential Software:\u003c/strong\u003e Comes pre-loaded with Firefox ESR for web browsing and the complete LibreOffice suite for productivity.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003e✨ User-Friendly:\u003c/strong\u003e Interactive prompts for username, password, and VNC screen resolution.\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003e⚡ Convenient Aliases:\u003c/strong\u003e Includes simple shortcuts for easy management.\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003chr\u003e\n\n\u003ch3\u003e► Requirements\u003c/h3\u003e\n\u003cul\u003e\n    \u003cli\u003eAn Android device (phone or tablet).\u003c/li\u003e\n    \u003cli\u003eThe \u003ca href=\"https://f-droid.org/en/packages/com.termux/\"\u003eTermux\u003c/a\u003e app installed.\u003c/li\u003e\n    \u003cli\u003eA VNC Viewer app (e.g., \u003ca href=\"https://play.google.com/store/apps/details?id=com.realvnc.viewer.android\"\u003eRealVNC\u003c/a\u003e, \u003ca href=\"https://play.google.com/store/apps/details?id=com.gaurav.avnc\"\u003eAVNC\u003c/a\u003e) installed on your Android device.\u003c/li\u003e\n    \u003cli\u003eApproximately 4-5 GB of free storage space.\u003c/li\u003e\n\u003c/ul\u003e\n\n\u003chr\u003e\n\n\u003ch3\u003e► Installation \u0026 Usage\u003c/h3\u003e\n\n\u003ch4\u003e1. Run the Installer\u003c/h4\u003e\n\u003cp\u003ePaste the one-line command below into your Termux terminal and press Enter.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003ebash -c \"$(curl -fsSL https://raw.githubusercontent.com/erfan2255/debian-on-android/main/setup.sh)\"\u003c/code\u003e\u003c/pre\u003e\n\n\u003ch4\u003e2. Follow the Prompts\u003c/h4\u003e\n\u003cp\u003eThe script will guide you through creating a username and password for your new Debian system.\u003c/p\u003e\n\n\u003ch4\u003e3. Log In\u003c/h4\u003e\n\u003cp\u003eAfter the installation is complete, a \u003ccode\u003edebian\u003c/code\u003e alias will be created in Termux. To log in, simply type:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003edebian\u003c/code\u003e\u003c/pre\u003e\n\n\u003ch4\u003e4. Start the VNC Server\u003c/h4\u003e\n\u003cp\u003eOnce you are logged into your Debian environment, start the graphical desktop by typing:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003estartvnc\u003c/code\u003e\u003c/pre\u003e\n\u003cblockquote\u003eThe first time you run this, you will be asked to select a screen resolution and set a VNC-specific password.\u003c/blockquote\u003e\n\n\u003ch4\u003e5. Connect with a VNC Client\u003c/h4\u003e\n\u003cp\u003eOpen your VNC Viewer app and create a new connection to the following address:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003elocalhost:1\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eEnter the VNC password you created in the previous step. You will now see your Debian desktop!\u003c/p\u003e\n\n\u003ch4\u003e6. Stop the VNC Server\u003c/h4\u003e\n\u003cp\u003eWhen you are finished with your session, you can stop the VNC server from inside Debian by typing:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003estopvnc\u003c/code\u003e\u003c/pre\u003e\n\n\u003chr\u003e\n\n\u003ch3\u003e► What's Included?\u003c/h3\u003e\n\u003ctable width=\"100%\" style=\"border-collapse: collapse;\"\u003e\n    \u003cthead\u003e\n        \u003ctr style=\"border-bottom: 1px solid #ddd;\"\u003e\n            \u003cth style=\"padding: 8px; text-align: left;\"\u003eComponent\u003c/th\u003e\n            \u003cth style=\"padding: 8px; text-align: left;\"\u003eDescription\u003c/th\u003e\n        \u003c/tr\u003e\n    \u003c/thead\u003e\n    \u003ctbody\u003e\n        \u003ctr\u003e\n            \u003ctd style=\"padding: 8px;\"\u003e\u003cstrong\u003eOperating System\u003c/strong\u003e\u003c/td\u003e\n            \u003ctd style=\"padding: 8px;\"\u003eDebian 13 (Trixie)\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd style=\"padding: 8px;\"\u003e\u003cstrong\u003eDesktop Environment\u003c/strong\u003e\u003c/td\u003e\n            \u003ctd style=\"padding: 8px;\"\u003eXFCE 4\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd style=\"padding: 8px;\"\u003e\u003cstrong\u003eWeb Browser\u003c/strong\u003e\u003c/td\u003e\n            \u003ctd style=\"padding: 8px;\"\u003eFirefox ESR\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd style=\"padding: 8px;\"\u003e\u003cstrong\u003eOffice Suite\u003c/strong\u003e\u003c/td\u003e\n            \u003ctd style=\"padding: 8px;\"\u003eLibreOffice (Writer, Calc, Impress, etc.)\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd style=\"padding: 8px;\"\u003e\u003cstrong\u003eVNC Server\u003c/strong\u003e\u003c/td\u003e\n            \u003ctd style=\"padding: 8px;\"\u003eTigerVNC\u003c/td\u003e\n        \u003c/tr\u003e\n        \u003ctr\u003e\n            \u003ctd style=\"padding: 8px;\"\u003e\u003cstrong\u003eSystem Utilities\u003c/strong\u003e\u003c/td\u003e\n            \u003ctd style=\"padding: 8px;\"\u003e\u003ccode\u003esudo\u003c/code\u003e, \u003ccode\u003enano\u003c/code\u003e, \u003ccode\u003eadduser\u003c/code\u003e, and more.\u003c/td\u003e\n        \u003c/tr\u003e\n    \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003chr\u003e\n\n\u003ch3\u003e► Screenshots\u003c/h3\u003e\n\u003cp\u003eHere is a preview of the Debian 13 XFCE desktop environment you will be installing.\u003c/p\u003e\n\n\u003cdiv style=\"display: flex; justify-content: center; align-items: center; flex-wrap: wrap; gap: 2rem; margin-top: 1rem;\"\u003e\n    \u003cdiv style=\"text-align: center;\"\u003e\n        \u003cimg src=\"https://github.com/erfan2255/debian-on-android/blob/main/Images/IMG_20250823_181327.png\" alt=\"Debian info\" style=\"width: 400px; max-width: 90%; border-radius: 15px; box-shadow: 0 10px 20px rgba(0,0,0,0.1);\"/\u003e\n        \u003cp\u003e\u003cstrong\u003eDebian info\u003c/strong\u003e\u003c/p\u003e\n    \u003c/div\u003e\n    \u003cdiv style=\"text-align: center;\"\u003e\n        \u003cimg src=\"https://github.com/erfan2255/debian-on-android/blob/main/Images/IMG_20250823_181349.png\" alt=\"Libre Office\" style=\"width: 400px; max-width: 90%; border-radius: 15px; box-shadow: 0 10px 20px rgba(0,0,0,0.1);\"/\u003e\n        \u003cp\u003e\u003cstrong\u003eLibre Office\u003c/strong\u003e\u003c/p\u003e\n    \u003c/div\u003e\n\u003c/div\u003e\n\n\u003chr\u003e\n\n\u003ch3\u003e► Show Your Support\u003c/h3\u003e\n\u003cp\u003eIf you find this project useful, please give it a ⭐ to show your support!\u003c/p\u003e\n\n\u003ch3\u003e► License\u003c/h3\u003e\n\u003cp\u003eThis project is licensed under the MIT License. See the \u003ca href=\"https://github.com/erfan2255/Debian-On-Android/blob/main/LICENSE\"\u003eLICENSE\u003c/a\u003e file for details.\u003c/p\u003e\n\n\u003chr\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003cp\u003e\u003cstrong\u003eby CoreLand\u003c/strong\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n\u003c/body\u003e\n\u003c/html\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferfan2255%2Fdebian-on-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferfan2255%2Fdebian-on-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferfan2255%2Fdebian-on-android/lists"}