AionUi in Android (Termux, prooted Debian and Ubuntu).md

Here’s a draft for the Wiki as per iOfficeAI/AionUi#37. Please add as new page, after some editing.

Running AionUi WebUI on Android via Termux + Proot Ubuntu (or similar OS)

Note: Electron desktop mode is unsupported on Android (process.platform === 'android' → ENOENT). Use WebUI in a prooted Linux for full functionality, as per below.
Ref: Closed issue #37

---

Prerequisites

• Termux (install from F-Droid)
• Storage access granted (termux-setup-storage)
• ~5 GB free space
• Internet (unmetered)

# In Termux
pkg update
pkg install proot-distro wget

Download the latest ARM64 .deb release of AionUi:

mkdir -p  ~/Downloads
cd ~/Downloads
wget https://github.com/iOfficeAI/AionUi/releases/download/v1.5.2/AionUi-1.5.2-linux-arm64.deb

---

Step-by-Step Setup

# 1. Install Ubuntu (or Debian etc) rootfs via proot
proot-distro install ubuntu

# 2. Enter the chroot
proot-distro login ubuntu

# 4. Install dependencies
apt update
apt install -y \
  libgtk-3-0 \
  libnotify4 \
  libnss3 \
  libxss1 \
  libxtst6 \
  xdg-utils \
  libatspi2.0-0 \
  libsecret-1-0 \
  libasound2t64

# 3. Install AionUi (deps will be missing — expected)
cd /data/data/com.termux/files/home/Downloads
dpkg -i AionUi-1.5.2-linux-arm64.deb

If a dependency be still missing, use e.g. apt list | grep [library name] to find its equivalent and install it.

# 5. Launch WebUI (no GUI, no sandbox)
AionUi --no-sandbox --webui

Server starts at: http://localhost:25808
Initial login: admin / random password shown in log
Change password immediately

Add --remote for LAN access from other devices.

---

Expected Errors (Ignore)

[ERROR:dbus/bus.cc] Failed to connect to socket /run/dbus/system_bus_socket
[ERROR:ui/ozone/platform/x11] Missing X server or $DISPLAY
[ERROR:device/udev_linux] Failed to initialize udev monitor

→ All should be non-fatal in WebUI mode, but if they be fatal, try: export DISPLAY=:1 etc. as per the error messages.

---

Alternative: Pure Termux (Unstable)

# Spoof platform + use Termux's electron
alias electron='/data/data/com.termux/files/usr/lib/electron26/electron'
npm install --platform linux
npm run webui

May hang at webpack or exit early. Proot Ubuntu is recommended.

---

Access the UI

• Local: Open http://localhost:25808 in Termux browser
• Remote: Use --remote → get LAN IP via ip route

---

You should see https://github.com/Manamama/Puzzles_for_AIs/blob/main/artifacts/Screenshot_2025-11-12-11-26-45-72.jpg

#Note to maintainers: I have uploaded real screenshot to https://github.com/Manamama/Puzzles_for_AIs/blob/main/artifacts/Screenshot_2025-11-12-11-26-45-72.jpg, for lack of better place and time - but rename it and copy it

Contributed by @Manamama — tested on Android 14, Termux 0.118.0, AionUi 1.5.2

---