fix: update Waydroid installation instructions to include Weston and clarify UI startup steps

This commit is contained in:
MickLesk
2026-05-26 13:14:58 +02:00
parent d021ba8cea
commit 9a3cbe754e
2 changed files with 21 additions and 12 deletions

View File

@@ -38,7 +38,7 @@
"type": "info" "type": "info"
}, },
{ {
"text": "Waydroid is pre-installed into the image before the VM boots. After first boot, run: sudo waydroid init && sudo systemctl start waydroid-container", "text": "Waydroid + Weston (Wayland compositor) are pre-installed. After first boot run: sudo waydroid init && sudo systemctl start waydroid-container. Then start the UI with: weston --backend=headless & && WAYLAND_DISPLAY=wayland-0 waydroid show-full-ui",
"type": "info" "type": "info"
}, },
{ {

View File

@@ -212,7 +212,7 @@ export LIBGUESTFS_BACKEND_SETTINGS=dns=8.8.8.8,1.1.1.1
WAYDROID_PREINSTALLED="no" WAYDROID_PREINSTALLED="no"
# Ubuntu ships binder_linux only in linux-modules-extra-generic # Ubuntu ships binder_linux only in linux-modules-extra-generic
BASE_PKGS="curl,ca-certificates,qemu-guest-agent" BASE_PKGS="curl,ca-certificates,qemu-guest-agent,weston"
[[ "$OS_CHOICE" == "ubuntu2404" ]] && BASE_PKGS="${BASE_PKGS},linux-modules-extra-generic" [[ "$OS_CHOICE" == "ubuntu2404" ]] && BASE_PKGS="${BASE_PKGS},linux-modules-extra-generic"
msg_info "Installing prerequisites in image" msg_info "Installing prerequisites in image"
@@ -264,7 +264,7 @@ exec >> /var/log/waydroid-install.log 2>&1
echo \"[\$(date)] Starting Waydroid installation\" echo \"[\$(date)] Starting Waydroid installation\"
for i in \$(seq 1 30); do ping -c1 8.8.8.8 >/dev/null 2>&1 && break; sleep 2; done for i in \$(seq 1 30); do ping -c1 8.8.8.8 >/dev/null 2>&1 && break; sleep 2; done
apt-get update apt-get update
apt-get install -y curl ca-certificates qemu-guest-agent apt-get install -y curl ca-certificates qemu-guest-agent weston
# Install binder_linux kernel module for Ubuntu # Install binder_linux kernel module for Ubuntu
if grep -qi ubuntu /etc/os-release; then if grep -qi ubuntu /etc/os-release; then
apt-get install -y linux-modules-extra-\$(uname -r) || apt-get install -y linux-modules-extra-generic apt-get install -y linux-modules-extra-\$(uname -r) || apt-get install -y linux-modules-extra-generic
@@ -345,12 +345,16 @@ if [ "$WAYDROID_PREINSTALLED" = "yes" ]; then
┌─────────────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────────────┐
│ WAYDROID IS PRE-INSTALLED │ │ WAYDROID IS PRE-INSTALLED │
├─────────────────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────────────────┤
│ Waydroid is already installed in the VM image. │ Waydroid + Weston are already installed in the VM image. │
│ After first boot, connect to the VM and run ONE final step: │ After first boot, connect to the VM and run:
│ │ │ │
sudo modprobe binder_linux 1. Initialize (once):
│ sudo waydroid init sudo waydroid init │
│ sudo systemctl start waydroid-container sudo systemctl start waydroid-container │
│ │
│ 2. Start Wayland compositor + Android UI (each session): │
│ weston --backend=headless & │
│ WAYLAND_DISPLAY=wayland-0 waydroid show-full-ui │
│ │ │ │
│ NOTE: GPU acceleration requires VirtIO GPU or passthrough setup. │ │ NOTE: GPU acceleration requires VirtIO GPU or passthrough setup. │
│ More info: https://docs.waydro.id/ │ │ More info: https://docs.waydro.id/ │
@@ -363,14 +367,19 @@ else
┌─────────────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────────────┐
│ WAYDROID FIRST-BOOT INSTALL ACTIVE │ │ WAYDROID FIRST-BOOT INSTALL ACTIVE │
├─────────────────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────────────────┤
│ Waydroid will be installed automatically on first boot. │ Waydroid + Weston will be installed automatically on first boot. │
│ Monitor progress inside the VM with: │ │ Monitor progress inside the VM with: │
│ sudo journalctl -u waydroid-firstboot -f │ │ sudo journalctl -u waydroid-firstboot -f │
│ sudo tail -f /var/log/waydroid-install.log │ │ sudo tail -f /var/log/waydroid-install.log │
│ │ │ │
│ After the service completes, run ONE final step: │ After the service completes:
sudo waydroid init 1. Initialize (once):
│ sudo systemctl start waydroid-container sudo waydroid init
│ sudo systemctl start waydroid-container │
│ │
│ 2. Start Wayland compositor + Android UI (each session): │
│ weston --backend=headless & │
│ WAYLAND_DISPLAY=wayland-0 waydroid show-full-ui │
│ │ │ │
│ NOTE: GPU acceleration requires VirtIO GPU or passthrough setup. │ │ NOTE: GPU acceleration requires VirtIO GPU or passthrough setup. │
│ More info: https://docs.waydro.id/ │ │ More info: https://docs.waydro.id/ │