Installation Guide
June 6, 2026 · View on GitHub
Note
Once installed, DebDroid can be safely updated by simply re-running the install script.It performs the necessary script and package updates packages without overwriting the existing image.
This guide is written for novice users. You only need basic knowledge of Android, like installing apps from unknown sources, extracting an archive, and a little experience using a terminal (command line).
Requirements
Supported Android versions:
- Requires an
aarch64Android device running Lollipop or later (released Nov 2014). - Covers devices launched in the past ~12 years, from Android 5 through Android 14.
Newer Android releases include improved virtualization support, which may provide a better alternative for some use cases.
Additional requirements:
- The device must be rooted.
- You’ll need at least 1 GB of free storage (5 GB is recommended for a comfortable experience).
What You Need
Before starting, make sure you have these apps installed on your device:
- Terminal Emulator - lets you access Android's command-line interface.
- Hacker's Keyboard - an advanced keyboard that makes typing commands easier.
- Root Explorer - lets you browse and manage Android files.
Alternatively, you can use a free alternative to Root Explorer, such as Explorer or MiXplorer.
Step 1: Downloading and Extracting the Project
- Download the project zip file: DebDroid-main.zip.
- Locate
DebDroid-main.zipin yourDownloadfolder (/sdcard/Download). - Extract the
DebDroid-main.ziparchive inside theDownloadfolder. You can use an application such asRoot ExplorerorMiXplorerfor this task.
After extraction, you should have a folder named DebDroid-main in your Download folder.
Step 2: Installing DebDroid
- Open the
Terminal Emulatorapp. - Type the following commands, pressing Enter after each one:
su
cd /sdcard/Download/DebDroid-main
sh install.sh
The script will automatically install DebDroid files in:
/data/local/debdroid/sdcard/debdroid
After that, DebDroid is ready to use!