crackercat/ubuntu-on-android

Run Ubuntu 21.04 with pre-installed Desktop Environments in android/termux with ease! Everything is preinstalled so just download install and done🚀🚀

Ubuntu 21.04 On android

A tweaked ubuntu-21.04 with xfce4 runs on android with termux/proot-distro

This means now you can install ubuntu like above screenshot right in your smartphone without destroying your phone with rooting

This project is
status
Maintainence status
Platform	Android Termux App (proot prtace() )
Linux Distribution
Community
Code quality & stats

• codename -> udroid

Note & Disclaimer (Must read !)

A note before you try

• As lot of it is preinstalled you can login and start right after you install
• As this runs on termux and on software rendering so performence clearly depends on CPU, ram and storage read-write speed!
• Don't try heavy apps unless you have a good device :)
• If you have any issues or suggestions make sure i know at https://github.com/RandomCoderOrg/ubuntu-on-android/issue (create an issue)

Disclaimer :

• i dont work with any company or organization of ubuntu or any third party sources took in making fs(for now).
• This project works by compliying to selinux android. and all aim of the project is just run linux on android without direct root with a twist and this project improves time by time with your support and motivation.
• the linux you trying to install from this repo is not fully functional in target space because of the selinux policies, and increasing requirement in linux requirements and also because project is set to run with ptrace() a low level access in android kernel
• Graphics performence is really bad cause proot and usage on VNC, we dont support any adoptation on improving it for now cause insufficient data on android (ping me in discord if you have any ideas or any codes on this)
• • (Update) see https://github.com/RandomCoderOrg/ubuntu-on-android/wiki/XWayland-in-proot to run smooth and fast session
• This project comes without warranties or data protection

supported architectures status

arch	status
arm64
armv7l
armv8l
amd64
Others	not started

Installation

• First install termux from termux.com or F-Droid!

Getting Sources and install scripts

# download installer
curl -L -o install.sh https://git.io/hippo-installer
# run the installer
bash install.sh
# Install ubuntu with this command
udroid --install

Basic Usage

Command	Usage
udroid	To login to shell
udroid upgrade	to upgrade fs or to get new features if available
startvnc	start vncserver at port 1 (you can change default port by exporting env varaible DEFAULT_VNC_PORT to a port number)
udroid stopvnc	stop vncserver at given or default port 1
udroid --enable-dbus	To start udroid with dbus hack enabled
udroid --enable-dbus-vnc	To start vnc session with dbus hack enabled

Environment Variables

• DEFAULT_VNC_PORT to set vnc port for scripts
• HIPPO_BRANCH to set custom branch for cloning code

🔊 Audio

pulseaudio starts everytime you invoke start commands with udroid

You can start audio manually with this command

pulseaudio --start --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1" --exit-idle-time=-1

Default passwords

	password
udroid user	secret
vncserver root	secret

some Screenshots

A small help from me if you want to build your own rootfs wiki_page

Devolopers & credits

Made with ❤️ from:

DEV #0 -> Saicharankandukuri

Dev #1 -> Gxmersam

Licence

MIT Copyright (c) 2021 Saicharan Kandukuri

More Updates coming soon 💛

• feel free to contribute to this repo :)