Run a full Debian Trixie desktop environment on your Android device — no root required.

• Full Debian Trixie environment with XFCE4 desktop
• Embedded VNC viewer — the desktop renders directly inside the app
• Integrated terminal for command-line access
• Persistent storage — your files survive app restarts
• File sharing between Android and Debian via shared folder
• Multi-window desktop managed by XFCE4's window manager
• One-time setup — download the rootfs once, use offline forever
• No root required — uses PRoot for filesystem isolation
• Lightweight — runs on any device with 4GB+ RAM

1. Download the latest APK from Releases
2. Install the APK
3. Launch the app and follow the onboarding
4. Download the Debian rootfs (~300-400MB)
5. Start your desktop!

(Coming soon)

┌─────────────────────────────────────────────┐
│              DebianDroid App                 │
│  ┌──────────┐ ┌──────────┐ ┌────────────┐  │
│  │ VNC      │ │ Terminal │ │ File       │  │
│  │ Viewer   │ │          │ │ Manager    │  │
│  └────┬─────┘ └────┬─────┘ └─────┬──────┘  │
│       │            │              │          │
│  ┌────┴────────────┴──────────────┴──────┐  │
│  │        DesktopService (Foreground)     │  │
│  │  ┌──────────┐  ┌──────────────────┐   │  │
│  │  │  PRoot   │  │  TigerVNC (Xvnc) │   │  │
│  │  └────┬─────┘  └───────┬──────────┘   │  │
│  └───────┼────────────────┼───────────────┘  │
│          │                │                   │
│  ┌───────┴────────────────┴───────────────┐  │
│  │         Debian Trixie Rootfs            │  │
│  │  XFCE4 + TigerVNC + apt + coreutils    │  │
│  └─────────────────────────────────────────┘  │
└─────────────────────────────────────────────┘

git clone https://github.com/highoncomputers/DebianDroid.git
cd DebianDroid
./gradlew assembleDebug

For release builds, set up the signing secrets:

keytool -genkey -v -keystore app/release.keystore -alias release -keyalg RSA -keysize 2048 -validity 10000
export KEYSTORE_PASSWORD=your_password
export KEY_ALIAS=release
export KEY_PASSWORD=your_password
./gradlew assembleRelease

• Language: Kotlin
• UI: Jetpack Compose + Material 3
• VNC: Custom RFB protocol implementation (Tight/CopyRect encoding)
• Isolation: PRoot (rootless chroot)
• Desktop: XFCE4 + TigerVNC server
• CI/CD: GitHub Actions
• Build: Gradle + AGP 8.5 | Kotlin 2.0 | Compose BOM 2024.10

See CONTRIBUTING.md for guidelines.

This project is open source. See LICENSE for details.

Report vulnerabilities privately via Security Advisories.