From ccdaa42949cd87bc30d86120d280569154655235 Mon Sep 17 00:00:00 2001 From: ravindu644 Date: Mon, 25 May 2026 10:25:56 +0530 Subject: [PATCH 01/22] build-docs.yml: update build workflow to use GITHUB_TOKEN for repository authentication enable manual triggering for documentation build workflow Signed-off-by: ravindu644 --- .github/workflows/build-docs.yml | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml index 00076fe..9cf0104 100644 --- a/.github/workflows/build-docs.yml +++ b/.github/workflows/build-docs.yml @@ -3,24 +3,23 @@ name: Build Docs on: repository_dispatch: types: [docs-updated] + workflow_dispatch: jobs: build: runs-on: ubuntu-latest + permissions: + contents: write steps: - uses: actions/checkout@v4 - name: Fetch latest docs from source repo - env: - PAT: ${{ secrets.SOURCE_REPO_PAT }} run: | - REPO="https://github.com/YOUR_USERNAME/YOUR_SOURCE_REPO.git" - if [ -n "$PAT" ]; then - REPO="https://x-access-token:${PAT}@github.com/YOUR_USERNAME/YOUR_SOURCE_REPO.git" - fi - git clone --depth 1 --branch main "$REPO" /tmp/source + git clone --depth 1 --branch main \ + https://github.com/ravindu644/Droidspaces-OSS.git /tmp/source rm -rf docs/content/ - cp -r /tmp/source/docs/content docs/content/ + mkdir -p docs/content + cp -r /tmp/source/Documentation/. docs/content/ - name: Build HTML run: python3 .github/scripts/build-docs.py @@ -31,8 +30,13 @@ jobs: - name: Commit and push run: | SHA="${{ github.event.client_payload.sha }}" + if [ -z "$SHA" ]; then + SHA=$(git -C /tmp/source rev-parse HEAD) + fi git config user.name "docs-bot" git config user.email "bot@droidspaces.org" + git remote set-url origin \ + https://x-access-token:${{ github.token }}@github.com/${{ github.repository }}.git git add -A git diff --cached --quiet || \ git commit -m "docs: update from source@${SHA:0:7}" && \ From 4ee1eb7e1e5df4e0619830dd6863e23c7ef737c5 Mon Sep 17 00:00:00 2001 From: ravindu644 Date: Mon, 25 May 2026 10:39:48 +0530 Subject: [PATCH 02/22] build-docs.py: remove hard coded root path Signed-off-by: ravindu644 --- .github/scripts/build-docs.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index e2b1ec5..cd050ac 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -1056,7 +1056,7 @@ def generate_sitemap(root): print("OK: sitemap.xml") if __name__ == '__main__': - root = '/home/tharukrj/Projects/droidspaces.github.io' + root = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) docs_dir = os.path.join(root, 'docs/content') out_dir = os.path.join(root, 'docs') From 863fdd0e032ae7224ac4f57267ed89e2fcc7585d Mon Sep 17 00:00:00 2001 From: docs-bot Date: Mon, 25 May 2026 05:13:15 +0000 Subject: [PATCH 03/22] docs: update from source@544e358 --- docs/community-supported-devices.html | 48 +++++++++++++-------------- docs/cool-things-you-can-do.html | 2 -- docs/features.html | 2 -- docs/gpu-acceleration.html | 2 -- docs/installation-android.html | 4 +-- docs/installation-linux.html | 2 -- docs/kernel-configuration.html | 18 +++++----- docs/linux-cli.html | 2 -- docs/nix-nixos.html | 2 -- docs/troubleshooting.html | 4 +-- docs/uninstallation.html | 2 -- docs/usage-android-app.html | 2 -- 12 files changed, 35 insertions(+), 55 deletions(-) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index fbb7229..0bfe9a3 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -362,7 +362,6 @@
Basics
-Getting Started Android Installation Linux Installation
@@ -381,7 +380,6 @@
Reference
Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation @@ -402,6 +400,7 @@

Non-GKI Devices (Kernel 4.19 and l Poco X2M1912G7BxBlissROM-v16.5 - Android 13-4.14.274KernelSU-Next v1.1.1SourceDownloadBothTurnip & VirglWorking@ravindu644- Realme 6, 6i, 6sRMX2001L1RUI 2.0 - Android 11-4.14.336KSU-Next v3.2.0 / ReSukiSU v4.1.0SourceDownloadBothVirglWorking@Prime-TITAN-CameraManRUI 2.0 only & No Firewall Support (UFW/Fail2ban) Redmi K20 Pro (China)M1903F11AYAAP 16 - Banshee (Android 16)1.0.c3-0061-1017_2229_f7c3bc9ce4.14.353KernelSU v3.2.4-gee75714aSourceDownloadBothTurnip & VirglWorking@AlhkxsjKernel source is stock YAAP kernel; Droidspaces configs applied via automated build workflow +Oneplus 8, 8T, 8Pro, 9RIN2010Lineage OS 23.2 - Android 16Q_V1_P144.19.325noneSourceDownloadBothTurnip & VirglWorking@JackA1ltmanCustom ROM only. Supported NTSYNC.

GKI Devices (Kernel 5.4 and up)

@@ -414,23 +413,23 @@

GKI Devices (Kernel 5.4 and up)

Galaxy A16 5GSM-A166POne UI 7.0 - Android 155.15.167KernelSU-Next v1.1.1SourceDownloadBothVirgl onlyWorking@ravindu644- Galaxy M14 4GSM-M145FOne UI 7.0 - Android 155.15.167KernelSU-Next v1.1.1SourceDownloadBothTurnip & VirglWorking@ravindu644- Galaxy A25 5GSM-A253ZOne UI 8.0 - Android 165.15.180MagiskSourceDownloadBothnoneWorking@yoshi3jp- -OnePlus Pad 2 Pro(Chinese variant)OPD2413ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 3 -OnePlus 13(Chinese variant)PJZ110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version -OnePlus 13(Chinese variant)PJZ110ColorOS 15.0 - Android 156.6.66noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version -OnePlus Ace 5 Pro(Chinese variant)PKR110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- -OnePlus Ace 5 Pro(Chinese variant)PKR110ColorOS 15.0 - Android 156.6.66noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- -OnePlus 13T(Chinese variant)PKX110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- -OnePlus 13T(Chinese variant)PKX110ColorOS 15.0 - Android 156.6.66noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- -OnePlus Ace 6(Chinese variant)PLR110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- -OnePlus Ace 3 Pro(Chinese variant)PJX110ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- -OnePlus Ace 3 Pro(Chinese variant)PJX110ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus Pad 2 Pro (Chinese variant)OPD2413ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 3 +OnePlus 13 (Chinese variant)PJZ110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version +OnePlus 13 (Chinese variant)PJZ110ColorOS 15.0 - Android 156.6.66noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version +OnePlus Ace 5 Pro (Chinese variant)PKR110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus Ace 5 Pro (Chinese variant)PKR110ColorOS 15.0 - Android 156.6.66noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus 13T (Chinese variant)PKX110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus 13T (Chinese variant)PKX110ColorOS 15.0 - Android 156.6.66noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus Ace 6 (Chinese variant)PLR110ColorOS 16.0 - Android 166.6.89noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus Ace 3 Pro (Chinese variant)PJX110ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus Ace 3 Pro (Chinese variant)PJX110ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- OnePlus Ace 5 (Chinese variant)PKG110ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus 13R OnePlus Ace 5 (Chinese variant)PKG110ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus 13R -OnePlus 12(Chinese variant)PJD110ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version -OnePlus 12(Chinese variant)PJD110ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version -OnePlus Pad Pro(Chinese variant)OPD2407ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) -OnePlus Pad Pro(Chinese variant)OPD2407ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) -Realme GT 5 Pro(Chinese variant)RMX3888RealmeUI 7.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +OnePlus 12 (Chinese variant)PJD110ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version +OnePlus 12 (Chinese variant)PJD110ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version +OnePlus Pad Pro (Chinese variant)OPD2407ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) +OnePlus Pad Pro (Chinese variant)OPD2407ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) +Realme GT 5 Pro (Chinese variant)RMX3888RealmeUI 7.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- OnePlus Ace 3 (Chinese variant)PJE110ColorOS 16.0 - Android 165.15.180noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus 12R OnePlus Ace 3 (Chinese variant)PJE110ColorOS 15.0 - Android 155.15.167noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus 12R OnePlus Ace 竞速版 (Chinese variant)PGZ110ColorOS 15.0 - Android 155.10.167ResukisuSourceDownloadBothbridge & VirglWorking@Goldzxcbug- @@ -439,7 +438,7 @@

GKI Devices (Kernel 5.4 and up)

Xiaomi 17 Pro (Chinese variant)2509FPN0BCHyperOS 3.0 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- Xiaomi 17 Pro max (Chinese variant)25113PN0ECHyperOS 3.0 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- 红魔 11 Pro (Chinese variant)NX809JRedMagicOS11 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- -HONOR Magic Pad 3 Pro 13.3(Chinese variant)YLP-W00MagicOS10 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +HONOR Magic Pad 3 Pro 13.3 (Chinese variant)YLP-W00MagicOS10 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- Xiaomi Pad 8 Pro (Chinese variant)25091RP04CHyperOS 3.0 - Android 166.6.77ResukisuSourceDownloadBothTurnip & VirglWorking404-GCrossApplicable to the international version
Supports NTsync Xiaomi 15 (Chinese variant)24129PN74CHyperOS 3.0 - Android 166.6.77ResukisuSourceDownloadBothTurnip & VirglWorking404-GCrossApplicable to the international version
Supports NTsync Xiaomi 14 (Chinese variant)23127PN0CCHyperOS 3.0 - Android 166.1.138ResukisuSourceDownloadBothTurnip & VirglWorking爱你么么哒qcjl哟Applicable to the international version @@ -447,13 +446,14 @@

GKI Devices (Kernel 5.4 and up)

红魔 9 SPro+ (Chinese variant)NX769JRedMagicOS11 - Android 166.1.25ResukisuSourceDownloadBothTurnip & VirglWorking@sjszero- Xiaomi Pad 6S Pro (Chinese variant)24018RPACCHyperOS 3.0 - Android 165.15.178ResukisuSourceDownloadBothTurnip & VirglWorking@mlfc666Applicable to the international version
Supports NTsync Redmi K70 (Chinese variant)23113RKC6CHyperOS 3.0 - Android 165.15.178ResukisuSourceDownloadBothTurnip & VirglWorking@mlfc666Supports NTsync -Xiaomi Pad 6 Max (Chinese variant)2307BRPDCCHyperOS 3.0 - Android 155.10.252noneLocally compiledDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsync -Xiaomi Pad 6 Pro (Chinese variant)2307BRPDCCHyperOS 3.0 - Android 155.10.252noneLocally compiledDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsync -Redmi K60 (Chinese variant)23013RK75CHyperOS 3.0 - Android 155.10.252noneLocally compiledDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsync -Redmi K50 Ultra (Chinese variant)22081212CHyperOS 3.0 - Android 155.10.252noneLocally compiledDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsync +Xiaomi Pad 6 Max (yudi)2307BRPDCCHyperOS 3.0 - Android 155.10.252noneSourceDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsync +Xiaomi Pad 6 Pro (liuqin)2307BRPDCCHyperOS 3.0 - Android 155.10.252noneSourceDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsync +Redmi K60 / POCO F5 Pro (mondrian)23013RK75CHyperOS 3.0 - Android 155.10.252noneSourceDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsyncApplicable to the international version +Redmi K50 Ultra / Xiaomi 12T Pro (diting)22081212CHyperOS 3.0 - Android 155.10.252noneSourceDownloadBothTurnip & VirglWorking@Star-ZER0Supports NTsyncApplicable to the international version Xiaomi 11T Pro (vili)2107113DerpFest A165.4KernelSU-NextSourceDownloadBothTurnip & VirglWorking@loystonpais- Redmi Note 13 4G / NFC23124RA7EOHyperOS 2.0 - Android 155.15.202Wild-KSU v3.1.2SourceDownloadBothTurnipWorking@superuseryuOther KSU variants may fail due to SELinux context reset. -Nothing Phone (1)A063crDroid - Android 165.4.302KernelSU-NextSourceDownloadBothTurnip & VirglWorking@MySelly- +Nothing Phone (1)A063crDroid - Android 165.4.302KernelSU-NextSourceDownloadBothTurnip & VirglWorking@MySelly- +Reno10 5GPMA110ColorOS15-16.1 - Android 15-165.4.254ReSukiSUSourceDownloadBothTurnipWorking@miaizhe-

Contribution guidelines

@@ -471,7 +471,7 @@

Contribution guidelines

  • Submit contributions through GitHub pull requests.
  • Update entries when status changes, and keep the information current.
    • -
    ← Common ErrorsNix / NixOS →
    +
    ← TroubleshootingNix / NixOS →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index 5854503..f0f4738 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation diff --git a/docs/features.html b/docs/features.html index 341e06f..2f12203 100644 --- a/docs/features.html +++ b/docs/features.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index cfb6c1a..c038d61 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation diff --git a/docs/installation-android.html b/docs/installation-android.html index 947e96c..a3f6f3b 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation @@ -422,7 +420,7 @@

    Next Steps

  • GPU Acceleration Guide to enable hardware-accelerated desktop environments.
  • Linux CLI Guide for expert command-line access.
    • -
    ← Getting StartedLinux Installation →
    +
    Linux Installation →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/installation-linux.html b/docs/installation-linux.html index f795723..54f700c 100644 --- a/docs/installation-linux.html +++ b/docs/installation-linux.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation diff --git a/docs/kernel-configuration.html b/docs/kernel-configuration.html index 790c119..1bd9922 100644 --- a/docs/kernel-configuration.html +++ b/docs/kernel-configuration.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation @@ -447,8 +445,9 @@

    Step 1: Mandatory Configuration

    # Overlay filesystem support (required for volatile mode) CONFIG_OVERLAY_FS=y -# Enable xattr support on tmpfs -# (required for NixOS setcap wrappers in /run/wrappers) +# Enable xattr, posix acl support on tmpfs +# For NixOS support +CONFIG_TMPFS_POSIX_ACL=y CONFIG_TMPFS_XATTR=y # Firmware loading support @@ -568,11 +567,11 @@

    Step 2: Edit gki_defconfig

    # HW Access Support CONFIG_DEVTMPFS=y -# --- Below configs are optional but recommended --- - -# Networking (Docker/NAT support) +# Networking (Enhanced NAT support) CONFIG_NETFILTER_XT_MATCH_ADDRTYPE=y +# --- Below configs are optional but recommended --- + # UFW support CONFIG_NETFILTER_XT_TARGET_REJECT=y CONFIG_NETFILTER_XT_TARGET_LOG=y @@ -584,8 +583,9 @@

    Step 2: Edit gki_defconfig

    CONFIG_IP_SET_HASH_NET=y CONFIG_NETFILTER_XT_SET=y -# Enable xattr support on tmpfs -# (required for NixOS setcap wrappers in /run/wrappers) +# Enable xattr, posix acl support on tmpfs +# For NixOS support +CONFIG_TMPFS_POSIX_ACL=y CONFIG_TMPFS_XATTR=y

    Workflow Rules: - Do not append this as a block at the end of the file. - Search for each option individually. - If an option appears as # CONFIG_NAME is not set, change it to CONFIG_NAME=y. - If an option is already set to CONFIG_NAME=y, leave it alone. - If an option does not exist, add it at the end.

    diff --git a/docs/linux-cli.html b/docs/linux-cli.html index f6ee77d..4cc5bed 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index 796cb61..9ad4a82 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index 87bdec6..7a8a524 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation @@ -640,7 +638,7 @@

    Getting Help

  • Join the Telegram channel for community support
  • Open an issue on the GitHub repository
    • -
    ← Cool Things You Can DoCommon Errors →
    +
    ← Cool Things You Can DoSupported Devices →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/uninstallation.html b/docs/uninstallation.html index 8c29141..bc70fa9 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index ad49487..87f712e 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    @@ -381,7 +380,6 @@
    Reference
    Troubleshooting -Common Errors Supported Devices Nix / NixOS Uninstallation From ae791319afbade4db8246daaebe25dccfde4ced1 Mon Sep 17 00:00:00 2001 From: ravindu644 Date: Mon, 25 May 2026 05:19:18 +0000 Subject: [PATCH 04/22] docs: remove getting-started page and all references --- .github/scripts/build-docs.py | 10 +- docs/common-errors.html | 1 - docs/getting-started.html | 539 ---------------------------------- docs/index.html | 8 +- index.html | 2 +- template.html | 1 - 6 files changed, 9 insertions(+), 552 deletions(-) delete mode 100644 docs/getting-started.html diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index cd050ac..75ec681 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -251,7 +251,7 @@ def convert_table(rows): SECTION_ORDER = {'Basics': 0, 'Guides': 1, 'Recipes': 2, 'Reference': 3} FALLBACK_TITLES = { - 'getting-started': 'Getting Started', 'installation-android': 'Android Installation', + 'installation-android': 'Android Installation', 'installation-linux': 'Linux Installation', 'features': 'Features Deep Dive', 'gpu-acceleration': 'GPU Acceleration', 'kernel-configuration': 'Kernel Configuration', 'usage-android-app': 'Android App Usage', 'linux-cli': 'Linux CLI Usage', @@ -261,7 +261,7 @@ def convert_table(rows): } FALLBACK_SECTIONS = { - 'getting-started': 'Basics', 'installation-android': 'Basics', 'installation-linux': 'Basics', + 'installation-android': 'Basics', 'installation-linux': 'Basics', 'features': 'Guides', 'gpu-acceleration': 'Guides', 'kernel-configuration': 'Guides', 'usage-android-app': 'Guides', 'linux-cli': 'Guides', 'cool-things-you-can-do': 'Recipes', @@ -270,7 +270,7 @@ def convert_table(rows): } FALLBACK_ORDER = { - 'getting-started': 1, 'installation-android': 2, 'installation-linux': 3, + 'installation-android': 1, 'installation-linux': 2, 'features': 1, 'gpu-acceleration': 2, 'kernel-configuration': 3, 'usage-android-app': 4, 'linux-cli': 5, 'cool-things-you-can-do': 1, @@ -279,7 +279,6 @@ def convert_table(rows): } FALLBACK_DESC = { - 'getting-started': 'Get started with Droidspaces \u2014 a lightweight ~400KB Linux container runtime for Android and Linux. Install, configure, and run your first container in minutes.', 'installation-android': 'Step-by-step Android installation guide for Droidspaces. Root your device, install the APK, set up the backend, and run Linux containers with zero terminal commands.', 'installation-linux': 'Install Droidspaces on Linux desktop or server. Download the tarball, extract the binary, create a rootfs image, and boot your first container.', 'features': 'Deep dive into every Droidspaces feature: namespace isolation, init system support, OverlayFS volatile mode, GPU acceleration, cgroup isolation, seccomp shields, and Android-specific tuning.', @@ -296,7 +295,6 @@ def convert_table(rows): } FALLBACK_KEYWORDS = { - 'getting-started': 'Droidspaces getting started, Linux containers Android, container runtime, namespaces, rootfs, kernel requirements', 'installation-android': 'install Droidspaces Android, rooted Android container, APK install, atomic backend, sparse image', 'installation-linux': 'install Droidspaces Linux, Linux container runtime, rootfs tarball, ext4 image, Linux namespaces', 'features': 'Droidspaces features, namespace isolation, cgroup v2, OverlayFS, volatile mode, init system, GPU hardware access', @@ -1034,7 +1032,7 @@ def generate_sitemap(root): '404.html': ('/404.html', 0.1), } doc_priorities = { - 'getting-started': 0.9, 'installation-android': 0.8, 'installation-linux': 0.8, + 'installation-android': 0.9, 'installation-linux': 0.8, 'features': 0.7, 'gpu-acceleration': 0.7, 'kernel-configuration': 0.7, 'usage-android-app': 0.7, 'linux-cli': 0.7, 'cool-things-you-can-do': 0.6, 'common-errors': 0.6, 'troubleshooting': 0.6, 'community-supported-devices': 0.5, diff --git a/docs/common-errors.html b/docs/common-errors.html index 7a7bf3d..0f9cf99 100644 --- a/docs/common-errors.html +++ b/docs/common-errors.html @@ -362,7 +362,6 @@
    Basics
    -Getting Started Android Installation Linux Installation
    diff --git a/docs/getting-started.html b/docs/getting-started.html deleted file mode 100644 index d24d637..0000000 --- a/docs/getting-started.html +++ /dev/null @@ -1,539 +0,0 @@ - - - - - - - - Getting Started - Droidspaces Docs - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - -
    -

    Getting Started with Droidspaces

    -

    Droidspaces is a lightweight, portable Linux container runtime that lets you run full Linux environments on Android, Linux, and even in Android recovery or ramdisks — with complete init system support including systemd, OpenRC, and others.

    -

    No Termux, no emulation, no dependencies. A single static binary under 400KB.

    -

    At a Glance

    -
      -
    • Tiny footprint — under 400KB per architecture, statically compiled against musl libc
      • -
    • Truly native — runs directly on Android and Linux from the same binary
      • -
    • Wide architecture support — aarch64, armhf, x86_64, x86, riscv64
      • -
    • Beautiful Android app — manage unlimited containers with a clean Material 3 GUI
      • -
    • Zero dependencies — no Termux, no additional packages required
      • -
    -

    Platform Requirements

    -

    Android

    -
      -
    • Kernel 3.10+
      • -
    • Rooted device (KernelSU, Magisk, or APatch)
      • -
    • Custom kernel with required config options (see Kernel Configuration)
      • -
    • ARM64, ARMhf, x86_64, or x86
      • -
    • Run the built-in checker: Settings → Requirements
      • -
    -

    Linux

    -
      -
    • Kernel 3.10+
      • -
    • Root access (not required if the daemon is running)
      • -
    • No custom kernel needed
      • -
    • ARM64, ARMhf, x86_64, x86, or RISC-V 64
      • -
    • Run sudo droidspaces check to verify
      • -
    -

    Installation

    - -

    Run Your First Container

    -

    Android

    -
      -
    1. Open the Droidspaces app
      2. -
    2. Tap + to create a new container
      3. -
    3. Select a rootfs
      4. -
    4. Configure settings (name, networking mode)
      5. -
    5. Tap Start
      6. -
    -

    Linux

    -
    sudo mkdir -p /var/lib/droidspaces/rootfs
-sudo tar -xzf ubuntu-rootfs.tar.gz -C /var/lib/droidspaces/rootfs
-sudo droidspaces --name=mycontainer --rootfs=/var/lib/droidspaces/rootfs start
-sudo droidspaces --name=mycontainer enter
-
    -

    What's Next?

    - -
    Android Installation →
    -

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors -

    -
    -
    - - - - \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index ca610cc..89da0fc 100644 --- a/docs/index.html +++ b/docs/index.html @@ -4,11 +4,11 @@ Documentation - Droidspaces - - - + + + -

    Redirecting to Getting Started...

    +

    Redirecting to Installation...

    diff --git a/index.html b/index.html index be8a734..219ebb4 100644 --- a/index.html +++ b/index.html @@ -159,7 +159,7 @@

    ↓ Download - Get Started →

    diff --git a/template.html b/template.html index 3ce990b..5884a76 100644 --- a/template.html +++ b/template.html @@ -22,7 +22,6 @@
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -427,8 +427,8 @@

    GKI Devices (Kernel 5.4 and up)

    OnePlus Ace 5 (Chinese variant)PKG110ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus 13R OnePlus 12 (Chinese variant)PJD110ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version OnePlus 12 (Chinese variant)PJD110ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugApplicable to the international version -OnePlus Pad Pro (Chinese variant)OPD2407ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) -OnePlus Pad Pro (Chinese variant)OPD2407ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) +OnePlus Pad Pro (Chinese variant)OPD2403ColorOS 16.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) +OnePlus Pad Pro (Chinese variant)OPD2403ColorOS 16.0 - Android 166.1.118noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus Pad 2 (International version) Realme GT 5 Pro (Chinese variant)RMX3888RealmeUI 7.0 - Android 166.1.141noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- OnePlus Ace 3 (Chinese variant)PJE110ColorOS 16.0 - Android 165.15.180noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus 12R OnePlus Ace 3 (Chinese variant)PJE110ColorOS 15.0 - Android 155.15.167noneSourceDownloadBothTurnip & VirglWorking@GoldzxcbugSuitable for OnePlus 12R @@ -453,7 +453,7 @@

    GKI Devices (Kernel 5.4 and up)

    Xiaomi 11T Pro (vili)2107113DerpFest A165.4KernelSU-NextSourceDownloadBothTurnip & VirglWorking@loystonpais- Redmi Note 13 4G / NFC23124RA7EOHyperOS 2.0 - Android 155.15.202Wild-KSU v3.1.2SourceDownloadBothTurnipWorking@superuseryuOther KSU variants may fail due to SELinux context reset. Nothing Phone (1)A063crDroid - Android 165.4.302KernelSU-NextSourceDownloadBothTurnip & VirglWorking@MySelly- -Reno10 5GPMA110ColorOS15-16.1 - Android 15-165.4.254ReSukiSUSourceDownloadBothTurnipWorking@miaizhe- +Reno10 5GPHW110ColorOS15-16.1 - Android 15-165.4.254ReSukiSUSourceDownloadBothTurnipWorking@miaizhe-

    Contribution guidelines

    @@ -471,7 +471,7 @@

    Contribution guidelines

  • Submit contributions through GitHub pull requests.
  • Update entries when status changes, and keep the information current.
    • -
    ← TroubleshootingNix / NixOS →
    +
    ← TroubleshootingGetting started with NixOS on Droidspaces →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index f0f4738..efb2c45 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -4,15 +4,15 @@ - - Cool Things You Can Do - Droidspaces Docs - + + Cool Things You Can Do with Droidspaces - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Recipes/Cool Things You Can Do + Docs/Recipes/Cool Things You Can Do with Droidspaces
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -544,7 +544,7 @@

    "Last Reso
    WARNING Above daemon.json configuration disables Docker's internal bridge (docker0) and all automatic port forwarding. You will only be able to run docker containers with internet with the --network host flag. eg: docker run -it --network host ubuntu
    -
    ← Linux CLI UsageTroubleshooting →
    +
    ← Linux CLI GuideTroubleshooting →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/features.html b/docs/features.html index 2f12203..2d6409b 100644 --- a/docs/features.html +++ b/docs/features.html @@ -4,15 +4,15 @@ - - Features Deep Dive - Droidspaces Docs - + + Feature Deep Dives - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Guides/Features Deep Dive + Docs/Guides/Feature Deep Dives
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -640,11 +640,57 @@

    Nested Containers (Docker, Podman,
    TIP Legacy Kernel Networking: When running Docker/Podman inside Droidspaces on legacy kernels, modern nftables may fail to route traffic. We recommend using Droidspaces' NAT mode and switching your container's networking stack to iptables-legacy and ip6tables-legacy.

    Android-Specific Tuning

    -

    Droidspaces includes several sophisticated subsystems designed specifically to handle the "opinionated" nature of the Android Linux kernel.

    -

    Safe Udev Trigger

    -

    Standard Linux distributions use udevadm trigger to "coldplug" hardware devices during boot. On many Android devices, triggering all devices simultaneously causes the kernel to deadlock or panic because Android's own hardware drivers (which are already running) do not expect another manager to re-trigger them.

    -

    The Solution: Droidspaces masks the standard udev trigger services and installs a Safe Udev Trigger. This service only triggers a strictly defined subset of subsystems (usb, block, input, tty) that are safe to re-scan. This enables the container to see new USB drives or keyboards without risking a system crash.

    -
    ← Linux InstallationGPU Acceleration →
    +

    To handle the "opinionated" nature of the Android Linux kernel and ensure container stability, network connectivity, and hardware access, several adjustments must be applied to the container's rootfs.

    +
    NOTE The Droidspaces backend itself does not alter the rootfs. These changes are applied automatically when the user installs a new rootfs tarball using the Android App's built-in installer, or are pre-baked when using our official rootfs tarball from the Droidspaces rootfs-builder.
    +

    1. Android Network & Hardware Groups

    +

    Older Android kernels restrict network socket creation and direct hardware access to specific, hardcoded Group IDs (GIDs). Droidspaces maps and configures these groups inside the container's rootfs:

    +
      +
    • GID Mapping: Appends Android-specific groups to /etc/group:
      • +
    • aid_inet (3003): Allows internet access.
      • +
    • aid_net_raw (3004): Allows raw socket creation (e.g., for ping).
      • +
    • aid_net_admin (3005): Allows network administration.
      • +
    • Permissions Assignment: Adds the container's root user to the aid_inet, aid_net_raw, input, video, and tty groups.
      • +
    • Package Manager Fix: Configures the Debian/Ubuntu _apt user to use aid_inet as its primary group, allowing packages to be installed and updated without permission errors.
      • +
    • User Automation: Modifies /etc/adduser.conf so any newly created user automatically inherits these groups.
      • +
    +

    2. Udev Trigger & Service Overrides

    +

    Standard Linux distributions run udevadm trigger to coldplug hardware devices during boot. Triggering all subsystems simultaneously on an Android device can cause the kernel to panic.

    +
      +
    • Hardware Access Guards: Since udev services are only useful when hardware access is explicitly enabled, Droidspaces injects a drop-in ExecCondition override that prevents systemd-udevd.service, systemd-udev-trigger.service, and systemd-udev-settle.service from starting unless the container is configured with hardware access (enable_hw_access=1):
      • +
    +
    [Service]
+ExecCondition=
+ExecCondition=/bin/sh -c "grep -q 'enable_hw_access=1' /run/droidspaces/container.config"
+
    +
      +
    • Safe Udev Trigger: Instead of scanning everything, Droidspaces overrides the default systemd-udev-trigger.service using a drop-in configuration. If hardware access is enabled, this limits the trigger to a strictly defined, safe subset of subsystems:
      • +
    +
    [Service]
+ExecStart=
+ExecStart=-/usr/bin/udevadm trigger --subsystem-match=usb --subsystem-match=block --subsystem-match=input --subsystem-match=tty --subsystem-match=net
+
    +

    This allows the container to dynamically detect new USB drives, keyboards, and network interfaces without risking a host crash. - Read-Only Path Fix: Overrides ConditionPathIsReadWrite for all udev units to prevent failures in environments where key system directories are mounted read-only.

    +

    3. Optimizing systemd & Logging

    +

    The Android kernel is notoriously verbose. Without tuning, standard journald setups would read host kernel messages and generate gigabytes of logs, quickly filling up the device's internal storage:

    +
      +
    • Journald Adjustments: Disables reading kernel messages and system auditing (ReadKMsg=no, Audit=no) in journald.conf to prevent the container from hoarding system-wide kernel logs.
      • +
    • Volatile Storage: Configures systemd journal logs to store in-memory only (Storage=volatile) and enforces strict maximum size constraints (200MB) to prevent constant writes from wearing out and filling the device's physical internal flash storage.
      • +
    • Service Masking: Masks systemd-networkd-wait-online.service to prevent boot delays, and systemd-journald-audit.socket to prevent systemd deadlocks in old kernels like 4.9.
      • +
    • Power Key Handling: Instructs systemd-logind to ignore host power and suspend key events so the container does not attempt to handle host power state transitions.
      • +
    +

    4. NAT Mode Network Guards

    +

    Under Host networking mode, running network managers like NetworkManager or systemd-networkd inside the container can conflict with the Android host's routing tables and break cellular/Wi-Fi connectivity.

    +

    Droidspaces injects a drop-in ExecCondition override for standard network services (such as NetworkManager.service, systemd-networkd.service, dhcpcd.service, and systemd-resolved.service). This ensures these services only execute if the container is explicitly configured in NAT mode:

    +
    [Service]
+ExecCondition=
+ExecCondition=/bin/sh -c "grep -q 'net_mode=nat' /run/droidspaces/container.config"
+
    +

    5. Storage and DHCP Configuration

    +
      +
    • systemd-networkd Config: Automatically configures 10-eth-dhcp.network to enable DHCP and IPv6 route acceptance for any eth* interfaces.
      • +
    • Logrotate Limit: Enforces a maxsize 50M limit in /etc/logrotate.conf to prevent logs from consuming excessive disk space over time.
      • +
    +
    ← Linux Installation GuideDroidspaces GPU Acceleration Guide →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index c038d61..dc6dd3c 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -3,17 +3,17 @@ - - - GPU Acceleration - Droidspaces Docs - - + + + Droidspaces GPU Acceleration Guide - Droidspaces Docs + + - - + + @@ -353,7 +353,7 @@ - Docs/Guides/GPU Acceleration + Docs/Guides/Droidspaces GPU Acceleration Guide
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -491,7 +491,7 @@

    Implementation Steps

  • Run Applications: GUI applications launched from the container will render natively with full hardware acceleration.
    • -
    ← Features Deep DiveKernel Configuration →
    +
    ← Feature Deep DivesKernel Configuration Guide →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/installation-android.html b/docs/installation-android.html index a3f6f3b..f0c61bb 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -4,15 +4,15 @@ - - Android Installation - Droidspaces Docs - + + Android Installation Guide - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Basics/Android Installation + Docs/Basics/Android Installation Guide
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -420,7 +420,7 @@

    Next Steps

  • GPU Acceleration Guide to enable hardware-accelerated desktop environments.
  • Linux CLI Guide for expert command-line access.
    • -
    Linux Installation →
    +
    Linux Installation Guide →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/installation-linux.html b/docs/installation-linux.html index 54f700c..1972152 100644 --- a/docs/installation-linux.html +++ b/docs/installation-linux.html @@ -4,15 +4,15 @@ - - Linux Installation - Droidspaces Docs - + + Linux Installation Guide - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Basics/Linux Installation + Docs/Basics/Linux Installation Guide
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -454,7 +454,7 @@

    Next Steps

  • Linux CLI Guide for complete command and flag reference
  • Feature Deep Dives for detailed explanations of each feature
    • -
    ← Android InstallationFeatures Deep Dive →
    +
    ← Android Installation GuideFeature Deep Dives →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/kernel-configuration.html b/docs/kernel-configuration.html index 1bd9922..e7cfcab 100644 --- a/docs/kernel-configuration.html +++ b/docs/kernel-configuration.html @@ -3,17 +3,17 @@ - - - Kernel Configuration - Droidspaces Docs - - + + + Kernel Configuration Guide - Droidspaces Docs + + - - + + @@ -353,7 +353,7 @@ - Docs/Guides/Kernel Configuration + Docs/Guides/Kernel Configuration Guide
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -676,7 +676,7 @@

    Additional Resources

  • Kernel Configuration Reference
  • Droidspaces Telegram Channel for kernel-specific support
    • -
    ← GPU AccelerationAndroid App Usage →
    +
    ← Droidspaces GPU Acceleration GuideAndroid App Usage Guide →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/linux-cli.html b/docs/linux-cli.html index 4cc5bed..43cdb7f 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -4,15 +4,15 @@ - - Linux CLI Usage - Droidspaces Docs - + + Linux CLI Guide - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Guides/Linux CLI Usage + Docs/Guides/Linux CLI Guide
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -631,7 +631,7 @@

    Next Steps

  • Troubleshooting
  • Android App Usage Guide
    • -
    ← Android App UsageCool Things You Can Do →
    +
    ← Android App Usage GuideCool Things You Can Do with Droidspaces →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index 9ad4a82..fa84e4f 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -4,15 +4,15 @@ - - Nix / NixOS - Droidspaces Docs - + + Getting started with NixOS on Droidspaces - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Reference/Nix / NixOS + Docs/Reference/Getting started with NixOS on Droidspaces
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -420,7 +420,7 @@

    Finix (no more systemd) (experimenta

    To build a Finix tarball:

    nix build github:ravindu644/Droidspaces-OSS#finixDroidspacesTarballs.aarch64-linux.experimental
    -
    ← Supported DevicesUninstallation →
    +
    ← Community-supported Android devicesUninstallation Guide →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index 7a8a524..0458973 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -4,7 +4,7 @@ - + Troubleshooting - Droidspaces Docs @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -638,7 +638,7 @@

    Getting Help

  • Join the Telegram channel for community support
  • Open an issue on the GitHub repository
    • -
    ← Cool Things You Can DoSupported Devices →
    +
    ← Cool Things You Can Do with DroidspacesCommunity-supported Android devices →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/uninstallation.html b/docs/uninstallation.html index bc70fa9..5aa8f37 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -4,15 +4,15 @@ - - Uninstallation - Droidspaces Docs - + + Uninstallation Guide - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Reference/Uninstallation + Docs/Reference/Uninstallation Guide
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -411,7 +411,7 @@

    Linux (CLI)

    # Or wherever you installed it -
    ← Nix / NixOS
    +
    ← Getting started with NixOS on Droidspaces

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index 87f712e..60673b2 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -4,15 +4,15 @@ - - Android App Usage - Droidspaces Docs - + + Android App Usage Guide - Droidspaces Docs + - + @@ -353,7 +353,7 @@ - Docs/Guides/Android App Usage + Docs/Guides/Android App Usage Guide
    @@ -362,27 +362,27 @@
    Basics
    -Android Installation -Linux Installation +Android Installation Guide +Linux Installation Guide
    Guides
    -Features Deep Dive -GPU Acceleration -Kernel Configuration -Android App Usage -Linux CLI Usage +Feature Deep Dives +Droidspaces GPU Acceleration Guide +Kernel Configuration Guide +Android App Usage Guide +Linux CLI Guide
    Recipes
    -Cool Things You Can Do +Cool Things You Can Do with Droidspaces
    Reference
    Troubleshooting -Supported Devices -Nix / NixOS -Uninstallation +Community-supported Android devices +Getting started with NixOS on Droidspaces +Uninstallation Guide
    @@ -455,7 +455,7 @@

    Method 2: External Terminal (Copy

    Settings & Requirements

    Accessed via the gear icon in the top right: - Requirements: Runs a 27-point diagnostic check on your kernel. - Kernel Config: Provides a copyable droidspaces.config snippet specifically for your device. - Theme Engine: Support for AMOLED Black, Material You, Changing accent colors, and Light/Dark modes.

    -
    ← Kernel ConfigurationLinux CLI Usage →
    +
    ← Kernel Configuration GuideLinux CLI Guide →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/sitemap.xml b/sitemap.xml index 37bd626..ab5d3a2 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -18,17 +18,11 @@ monthly 0.1 - - https://www.droidspaces.org/docs/getting-started.html - 2026-05-23 - monthly - 0.9 - https://www.droidspaces.org/docs/installation-android.html 2026-05-23 monthly - 0.8 + 0.9 https://www.droidspaces.org/docs/installation-linux.html From 77752bea09a954f2a7d0b19051032fb88cc59082 Mon Sep 17 00:00:00 2001 From: Tharuk Renuja <90763454+TharukRenuja@users.noreply.github.com> Date: Mon, 25 May 2026 13:40:06 +0530 Subject: [PATCH 06/22] Nuked ``Common Errors and Source Workflow Reference`` (#4) --- SOURCE_WORKFLOW_REFERENCE.yml | 31 -- docs/common-errors.html | 630 ---------------------------------- sitemap.xml | 6 - 3 files changed, 667 deletions(-) delete mode 100644 SOURCE_WORKFLOW_REFERENCE.yml delete mode 100644 docs/common-errors.html diff --git a/SOURCE_WORKFLOW_REFERENCE.yml b/SOURCE_WORKFLOW_REFERENCE.yml deleted file mode 100644 index 2d1d4df..0000000 --- a/SOURCE_WORKFLOW_REFERENCE.yml +++ /dev/null @@ -1,31 +0,0 @@ -# Place this file in your SOURCE repo at: -# .github/workflows/docs-updated.yml -# -# Replace USERNAME/REPO with the actual source repo path. -# The WEB_REPO_PAT must be a classic PAT with `repo` scope, -# stored as a secret in the source repo's Settings → Secrets → Actions. - -on: - push: - branches: [main] - paths: - - 'docs/content/**' - - 'mkdocs.yml' # optional — trigger on config changes too - -jobs: - dispatch: - runs-on: ubuntu-latest - steps: - - uses: actions/github-script@v7 - with: - github-token: ${{ secrets.WEB_REPO_PAT }} - script: | - await github.rest.repos.createDispatchEvent({ - owner: 'droidspaces', - repo: 'droidspaces.github.io', - event_type: 'docs-updated', - client_payload: { - ref: context.ref, - sha: context.sha - } - }); diff --git a/docs/common-errors.html b/docs/common-errors.html deleted file mode 100644 index 0f9cf99..0000000 --- a/docs/common-errors.html +++ /dev/null @@ -1,630 +0,0 @@ - - - - - - - - Common Errors - Droidspaces Docs - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - -
    -

    Common Errors & Solutions

    -

    A comprehensive collection of known errors, their causes, and fixes for Droidspaces.

    -
    -

    Installation & Setup Errors

    -

    GrapheneOS Not Supported

    -

    Error: Droidspaces fails to run on GrapheneOS.

    -

    Cause: GrapheneOS blocks critical syscalls needed for namespace isolation and containerization, making it impossible to run a userspace runtime like Droidspaces even with root access.

    -

    Solution: GrapheneOS is not supported. Use a different ROM or device.

    -
    -

    SuSFS Conflicts

    -

    Error: Containers fail to boot when SuSFS is installed.

    -

    Cause: SuSFS interferes with Droidspaces' filesystem operations.

    -

    Solution: Ensure "HIDE SUS MOUNTS FOR ALL PROCESSES" is disabled in your SuSFS4KSU settings. Do not report bugs when using SuSFS.

    -
    -

    "Required key not available" (ENOKEY)

    -

    Symptoms: Container crashes or filesystem operations fail with "Required key not available" errors. Most common on Android devices with File-Based Encryption (FBE).

    -

    Cause: systemd services inside the container attempt to create new session keyrings, causing the process to lose access to Android's FBE encryption keys.

    -

    Affected kernels: 3.18, 4.4, 4.9, 4.14, 4.19

    -

    Solution: - Update Droidspaces to v4.2.4+ - Run droidspaces check to verify seccomp support - Ensure CONFIG_SECCOMP=y and CONFIG_SECCOMP_FILTER=y in your kernel - Switch to rootfs.img mode (recommended on Android) - Advanced: Decrypt /data by editing fstab in boot partitions

    -
    -

    Mount Errors on Kernel 4.14

    -

    Symptoms: First container start after stopping fails with a mount error, but retry succeeds.

    -

    Cause: On kernel 4.14, loop device cleanup is asynchronous. After unmounting a rootfs image, the loop device may not be fully released.

    -

    Solution: Droidspaces v4.2.3+ handles this automatically with a 3-attempt retry loop. If still experiencing issues: - Update to the latest version - Wait a few seconds between stop and start - Use sync before restarting

    -
    -

    OverlayFS Not Supported (f2fs)

    -

    Symptoms: --volatile mode fails with an error about OverlayFS not supporting f2fs.

    -

    Cause: Most Android devices use f2fs for /data. OverlayFS on many Android kernels does not support f2fs as a lower directory.

    -

    Solution: Use a rootfs image instead of a directory:

    -
    # Will fail on f2fs:
-droidspaces --rootfs=/data/rootfs --volatile start
-
-# Will work:
-droidspaces --name=test --rootfs-img=/data/rootfs.img --volatile start
-
    -
    -

    Runtime Errors

    -

    Container Name Conflicts

    -

    Symptoms: Starting a container fails because a container with the same name is already running, or PID file conflicts occur.

    -

    Solution: 1. Check running containers: droidspaces show 2. Clean up stale state: droidspaces scan 3. Use a different name: droidspaces --name=mycontainer-2 start

    -
    -

    Systemd Hangs on Older Kernels

    -

    Symptoms: systemd hangs or becomes unresponsive on legacy kernels (3.18, 4.4, 4.9, 4.14, 4.19).

    -

    Cause: systemd's service sandboxing triggers a race condition in the kernel's VFS grab_super path.

    -

    Solution: Enable the Deadlock Shield in the app or use --block-nested-namespaces in CLI, hard reboot, and try again.

    -
    -

    Container Won't Stop

    -

    Symptoms: droidspaces stop takes more than 15 seconds and eventually fails.

    -

    Cause: Same as systemd hangs on older kernels — VFS deadlock.

    -

    Solution: Enable the Deadlock Shield, hard reboot, and try again.

    -
    -

    Modern Distros Fail on Legacy Kernels

    -

    Symptoms: Arch Linux, Fedora, or openSUSE fail to boot with "Unsupported Kernel" or hang during systemctl commands.

    -

    Cause: Modern systemd (v258+) requires kernel features not present in kernels older than 5.4.

    -

    Solution: - Use distributions with OpenRC, runit, or s6 - Use Ubuntu 22.04/24.04/25.04 or Debian 12/13 (older systemd) - Use Alpine Linux (OpenRC-based)

    -
    -

    Networking Errors

    -

    Ping Fails with "socket: permission denied"

    -

    Cause: Android Paranoid Networking — the kernel restricts socket creation to specific GIDs (AID_INET 3003, AID_NET_RAW 3004, AID_NET_ADMIN 3005).

    -

    Solution: - Kernel level: Set CONFIG_ANDROID_PARANOID_NETWORK=n - Userland: Use our pre-patched rootfs tarballs

    -
    -

    DNS / Name Resolution Issues

    -

    Symptoms: Internet works (can ping IPs), but domain names fail to resolve.

    -

    Cause: Some ISPs block common DNS servers like 8.8.8.8 and 1.1.1.1.

    -

    Solution: Use your ISP's DNS servers:

    -
    dumpsys connectivity | sed 's/}}/\n/g' | grep 'InterfaceName: wlan0' | grep -o 'DnsAddresses: \[[^]]*\]' | grep -o '/[0-9]*\.[0-9]*\.[0-9]*\.[0-9]*' | tr -d '/'
-
    -

    Add the results as DNS servers in the container configuration.

    -
    -

    WiFi/Mobile Data Disconnects

    -

    Symptoms: WiFi or mobile data stops working on the host during container start/stop.

    -

    Cause: systemd-networkd inside the container conflicts with Android's network management.

    -

    Solution: - Mask systemd-networkd inside the container:

    -
    sudo systemctl mask systemd-networkd
-
    -
      -
    • Use isolated NAT mode (--net=nat)
      • -
    -
    -

    Wi-Fi Power Save Causes Sluggish Networking

    -

    Symptoms: Slow networking when the device screen is off.

    -

    Solution: Create a watchdog container to keep Wi-Fi power save disabled:

    -
    # Install iw
-apk add iw  # Alpine
-apt install iw  # Debian/Ubuntu
-
-# Create watchdog script at /usr/local/bin/wifi-watchdog.sh
-while true; do
-    if iw dev wlan0 get power_save 2>/dev/null | grep -q "on"; then
-        iw dev wlan0 set power_save off
-    fi
-    sleep 60
-done
-
    -

    Set up as an OpenRC or systemd service. Requires host networking mode (--net=host).

    -
    -

    Filesystem & Storage Errors

    -

    SELinux-Induced Rootfs Corruption (Directory Mode)

    -

    Symptoms: Symbolic link sizes changing unexpectedly, library load failures, or random binary crashes.

    -

    Cause: Android's SELinux policy assigns a generic context to /data/local/Droidspaces/Containers, interfering with filesystem operations in directory mode.

    -

    Solution: Switch to rootfs.img mode (--rootfs-img=/path/to/rootfs.img). This encapsulates the filesystem inside an ext4 image, preventing SELinux from relabeling individual files.

    -
    -

    Rootfs Image I/O Errors on Android

    -

    Symptoms: Loop-mounting a rootfs image silently fails.

    -

    Cause: The SELinux context of the .img file prevents the loop driver from performing I/O.

    -

    Solution: Droidspaces v4.3.0+ applies the correct SELinux context automatically. For older versions:

    -
    chcon u:object_r:vold_data_file:s0 /path/to/rootfs.img
-
    -
    -

    Reclaiming Storage After Deletion (Sparse Image)

    -

    Symptoms: rootfs.img doesn't shrink after deleting files inside the container.

    -

    Cause: The host filesystem can't detect when blocks are freed inside the ext4 image.

    -

    Solution: Run fstrim inside the container:

    -
    sudo fstrim -av
-
    -
    -

    Systemd Service Errors

    -

    Systemd Service Sandboxing Conflicts (Legacy Kernels)

    -

    Symptoms: Services like redis, mysql, or apache fail with exit-code or status=226/NAMESPACE.

    -

    Cause: Modern systemd sandboxing directives conflict with Droidspaces' Adaptive Seccomp Shield on legacy kernels.

    -

    Solution: Create a service override:

    -
    sudo systemctl edit 
-
    -

    Add:

    -
    [Service]
-PrivateTmp=no
-PrivateDevices=no
-ProtectSystem=no
-ProtectHome=no
-RestrictNamespaces=no
-MemoryDenyWriteExecute=no
-NoNewPrivileges=no
-CapabilityBoundingSet=
-
    -

    Then:

    -
    sudo systemctl daemon-reload
-sudo systemctl restart 
-
    -
    -

    Getting Help

    -

    If your issue isn't listed here:

    -
      -
    1. Run droidspaces check and note any failures
      2. -
    2. Check container logs: droidspaces --name=mycontainer run journalctl -n 100
      3. -
    3. Try foreground mode: droidspaces --name=mycontainer --rootfs=/path/to/rootfs --foreground start
      4. -
    4. Join the Telegram channel for community support
      5. -
    5. Open an issue on the GitHub repository
      6. -
    -
    ← TroubleshootingSupported Devices →
    -

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors -

    -
    -
    - - - - \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index ab5d3a2..3b6be08 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -66,12 +66,6 @@ monthly 0.6     - - https://www.droidspaces.org/docs/common-errors.html - 2026-05-23 - monthly - 0.6 - https://www.droidspaces.org/docs/troubleshooting.html 2026-05-23 From 70139ae3c8cc4891b5f6073f8b2c924254c1869c Mon Sep 17 00:00:00 2001 From: Tharuk Renuja <90763454+TharukRenuja@users.noreply.github.com> Date: Mon, 25 May 2026 14:48:48 +0530 Subject: [PATCH 07/22] Fixed Mobile overflow issues & Adjusted Docs layout utilize full width on Desktop (#5) * Nuked ``Common Errors and Source Workflow Reference`` * Fixed Mobile overflow issues & Adjusted Docs layout utilize full width on Desktop. --- .github/scripts/build-docs.py | 7 +++++-- docs/community-supported-devices.html | 6 ++++-- docs/cool-things-you-can-do.html | 6 ++++-- docs/features.html | 6 ++++-- docs/gpu-acceleration.html | 6 ++++-- docs/installation-android.html | 6 ++++-- docs/installation-linux.html | 6 ++++-- docs/kernel-configuration.html | 7 +++++-- docs/linux-cli.html | 6 ++++-- docs/nix-nixos.html | 6 ++++-- docs/troubleshooting.html | 6 ++++-- docs/uninstallation.html | 6 ++++-- docs/usage-android-app.html | 6 ++++-- 13 files changed, 54 insertions(+), 26 deletions(-) diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index 75ec681..11269e4 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -466,7 +466,7 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= .sidebar-content {{ flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; }} .sidebar-content h1 {{ font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -497,12 +497,14 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= .sidebar-content strong {{ color: var(--text); }} .sidebar-content a {{ color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content a:hover {{ text-decoration: underline; }} .sidebar-content code {{ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content pre {{ background: var(--bg2); border: 1px solid var(--border); @@ -566,7 +568,8 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; }} .sidebar-content td {{ padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index e4f0d8b..b36f248 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index efb2c45..80e73a0 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/features.html b/docs/features.html index 2d6409b..0389cce 100644 --- a/docs/features.html +++ b/docs/features.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index dc6dd3c..7349763 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/installation-android.html b/docs/installation-android.html index f0c61bb..ea90e4e 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/installation-linux.html b/docs/installation-linux.html index 1972152..db45857 100644 --- a/docs/installation-linux.html +++ b/docs/installation-linux.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/kernel-configuration.html b/docs/kernel-configuration.html index e7cfcab..da22556 100644 --- a/docs/kernel-configuration.html +++ b/docs/kernel-configuration.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,12 +95,14 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); @@ -164,7 +166,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/linux-cli.html b/docs/linux-cli.html index 43cdb7f..99d1612 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index fa84e4f..8901d5e 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index 0458973..27c056f 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/uninstallation.html b/docs/uninstallation.html index 5aa8f37..7bb7ec2 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index 60673b2..6b36ffe 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -64,7 +64,7 @@ .sidebar-content { flex: 1; min-width: 0; padding: 2rem 2rem 4rem; - max-width: 960px; + max-width: none; } .sidebar-content h1 { font-family: var(--mono); font-size: clamp(1.5rem, 2.5vw, 2rem); @@ -95,6 +95,7 @@ .sidebar-content strong { color: var(--text); } .sidebar-content a { color: var(--accent2); text-decoration: none; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content a:hover { text-decoration: underline; } .sidebar-content code { @@ -164,7 +165,8 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: nowrap; + white-space: normal; + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); From d406f98266e5749ff4071831bcb2e8de69173c91 Mon Sep 17 00:00:00 2001 From: docs-bot Date: Mon, 25 May 2026 09:19:40 +0000 Subject: [PATCH 08/22] docs: update from source@2d9c389 --- docs/community-supported-devices.html | 1 + docs/cool-things-you-can-do.html | 1 + docs/features.html | 1 + docs/gpu-acceleration.html | 1 + docs/installation-android.html | 1 + docs/installation-linux.html | 1 + docs/linux-cli.html | 1 + docs/nix-nixos.html | 1 + docs/troubleshooting.html | 1 + docs/uninstallation.html | 1 + docs/usage-android-app.html | 1 + sitemap.xml | 6 ++++++ 12 files changed, 17 insertions(+) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index b36f248..f4eb37b 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index 80e73a0..e583294 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/features.html b/docs/features.html index 0389cce..c453b57 100644 --- a/docs/features.html +++ b/docs/features.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index 7349763..d066bbf 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/installation-android.html b/docs/installation-android.html index ea90e4e..bb2e62d 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/installation-linux.html b/docs/installation-linux.html index db45857..16b63a6 100644 --- a/docs/installation-linux.html +++ b/docs/installation-linux.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/linux-cli.html b/docs/linux-cli.html index 99d1612..b19a18b 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index 8901d5e..da0e823 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index 27c056f..d7790f3 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/uninstallation.html b/docs/uninstallation.html index 7bb7ec2..0976385 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index 6b36ffe..fe5cba5 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -102,6 +102,7 @@ font-family: var(--mono); font-size: 0.82rem; background: var(--bg3); padding: 0.15rem 0.4rem; border-radius: 4px; color: var(--accent2); + word-break: break-word; overflow-wrap: anywhere; } .sidebar-content pre { background: var(--bg2); border: 1px solid var(--border); diff --git a/sitemap.xml b/sitemap.xml index 3b6be08..ab5d3a2 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -66,6 +66,12 @@ monthly 0.6 + + https://www.droidspaces.org/docs/common-errors.html + 2026-05-23 + monthly + 0.6 + https://www.droidspaces.org/docs/troubleshooting.html 2026-05-23 From d727e09760f903db1f9e1f396aef2bd78907d6f1 Mon Sep 17 00:00:00 2001 From: docs-bot Date: Mon, 25 May 2026 19:42:22 +0000 Subject: [PATCH 09/22] docs: update from source@d10e1a3 --- docs/community-supported-devices.html | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index f4eb37b..4398743 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -392,6 +392,9 @@

    Community-supported Android devices

    NOTE If you want to add your own Droidspaces kernel to this table, check out the Contribution guidelines section.
    +
    WARNING Flashing a custom kernel requires an unlocked bootloader. The Droidspaces developers are not responsible for any bricked devices, data loss, or hardware failure resulting from kernel installation. +This list is provided solely to help you locate device-specific source code. +These repositories have not been deeply audited or reviewed by the Droidspaces team. Proceed at your own risk.

    This document is a community-maintained compatibility list for Android devices known to run Droidspaces successfully. It is intended to help people choose phones for self-hosting, especially when buying second-hand hardware.

    Non-GKI Devices (Kernel 4.19 and lower)

    From 91ca6120e49f609da573925157f38cfcd0763387 Mon Sep 17 00:00:00 2001 From: docs-bot Date: Mon, 25 May 2026 19:47:57 +0000 Subject: [PATCH 10/22] docs: update from source@de01881 --- docs/cool-things-you-can-do.html | 4 ++-- docs/gpu-acceleration.html | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index e583294..ee344b9 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -394,8 +394,8 @@

    Cool Things You Can Do with Dro
    IMPORTANT This guide is specifically focused on Android devices. While Droidspaces also runs on Linux Desktop, these instructions address the unique networking, storage, and kernel requirements of the Android environment.

    Quick Navigation

    1. Setting Up a Secure "Mobile Server" (Tailscale + UFW + Fail2Ban)

    diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index d066bbf..5798ce0 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -394,8 +394,8 @@

    Droidspaces GPU Acceleration GuideThis guide provides step-by-step instructions for enabling GPU acceleration in your Droidspaces containers. Whether you are running on an Android device or a Linux desktop, Droidspaces offers multiple ways to leverage hardware acceleration for a smooth graphical experience.

    Quick Navigation

    From 6147ba83e757a357c390190d14c80a93bad060e6 Mon Sep 17 00:00:00 2001 From: Ravindu Deshan Date: Tue, 26 May 2026 20:12:58 +0530 Subject: [PATCH 11/22] Update software version to 6.2.0 in index.html --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 219ebb4..5f1bcdf 100644 --- a/index.html +++ b/index.html @@ -62,7 +62,7 @@ "Material 3 management app with built-in terminal" ], "fileSize": "400KB", - "softwareVersion": "6.1.5", + "softwareVersion": "6.2.0", "license": "https://github.com/ravindu644/Droidspaces-OSS/blob/main/LICENSE", "sameAs": [ "https://github.com/ravindu644/Droidspaces-OSS", @@ -141,7 +141,7 @@
    -
    v6.1.5 · Open Source
    +
    v6.2.0 · Open Source

    Linux containers
    on From 662ca9c34fea1501edf512e8e7a972d2c80ee998 Mon Sep 17 00:00:00 2001 From: ravindu644 Date: Wed, 27 May 2026 12:11:29 +0530 Subject: [PATCH 12/22] feat: update documentation, fix UI bugs --- .github/scripts/build-docs.py | 154 +++++++++++------- docs/community-supported-devices.html | 45 ++++-- docs/cool-things-you-can-do.html | 173 ++++++++++++++------ docs/features.html | 187 ++++++++++++++-------- docs/gpu-acceleration.html | 165 +++++++++++++------ docs/installation-android.html | 62 ++++--- docs/installation-linux.html | 48 ++++-- docs/kernel-configuration.html | 110 ++++++++----- docs/linux-cli.html | 21 ++- docs/nix-nixos.html | 12 +- docs/troubleshooting.html | 168 ++++++++++++------- docs/uninstallation.html | 58 +++++-- docs/usage-android-app.html | 87 ++++++---- downloads.html | 222 +++++++++++++++++--------- style.css | 14 +- 15 files changed, 1033 insertions(+), 493 deletions(-) diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index 11269e4..d0fb246 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -138,72 +138,98 @@ def md_to_html(md): html.append(convert_table(rows)) continue - # Ordered lists - olm = re.match(r'^\s*\d+\.\s+(.+)$', line) - if olm: - items = [] - while i < len(lines) and re.match(r'^\s*\d+\.\s+', lines[i]): - item_text = re.sub(r'^\s*\d+\.\s+', '', lines[i]) - item_html = inline_format(item_text) - i += 1 - extra = [] - while i < len(lines): - s = lines[i].lstrip() - indent = len(lines[i]) - len(s) - if indent >= 3 and s.startswith('```'): - ch, i = consume_code(lines, i) - extra.append(ch) - elif indent >= 3 and s.startswith('> '): - extra.append(f'
    {inline_format(s[2:])}
    ') - i += 1 - elif lines[i].strip() == '': - i += 1 - continue - elif indent >= 3 and s.strip(): - extra.append(inline_format(s)) - i += 1 - else: - break - items.append(f'
  • {" ".join(extra) if item_html == "" else item_html}{"".join(extra) if item_html != "" else ""}
    • ') - # Fix: combine item_html with extra - fixed_items = [] - for item in items: - fixed_items.append(item) - html.append('
      \n' + '\n'.join(items) + '\n
    ') - continue + # Lists (ordered and unordered) — stack-based recursive nesting + def is_list_item(ln): + return bool(re.match(r'^(\s*)(?:\d+\.|[-*+])\s+', ln)) + + def item_indent(ln): + m = re.match(r'^(\s*)', ln) + return len(m.group(1)) if m else 0 + + def item_tag(ln): + """Return 'ol' for ordered, 'ul' for unordered.""" + stripped = ln.lstrip() + return 'ol' if re.match(r'^\d+\.\s+', stripped) else 'ul' + + def item_text_content(ln): + return re.sub(r'^\s*(?:\d+\.|[-*+])\s+', '', ln) - # Unordered lists - ulm = re.match(r'^[\s]*[-*+]\s+', line) - if ulm: - items = [] - while i < len(lines) and re.match(r'^[\s]*[-*+]\s+', lines[i]): - item_text = re.sub(r'^[\s]*[-*+]\s+', '', lines[i]) - item_html = inline_format(item_text) + def consume_list(lines, start, base_indent): + """Recursively parse a list starting at `start` with `base_indent`. + Returns (html_string, next_line_index).""" + i = start + tag = item_tag(lines[i]) + parts = [f'<{tag}>'] + while i < len(lines): + ln = lines[i] + if not ln.strip(): + # blank line — peek ahead to see if list continues + j = i + 1 + while j < len(lines) and not lines[j].strip(): + j += 1 + if j < len(lines) and is_list_item(lines[j]) and item_indent(lines[j]) >= base_indent: + i = j + continue + break + if not is_list_item(ln): + break + ind = item_indent(ln) + if ind < base_indent: + break + if ind > base_indent: + # deeper — recurse as nested list inside current
  • + nested_html, i = consume_list(lines, i, ind) + parts.append(nested_html) + continue + # Same indent — new sibling list item + # Close previous
  • if open + if parts[-1] != f'<{tag}>': + parts.append('
    • ') + text = inline_format(item_text_content(ln)) + parts.append(f'
  • {text}') i += 1 - extra = [] + # Consume continuation content (code blocks, blockquotes, plain text) while i < len(lines): - s = lines[i].lstrip() - indent = len(lines[i]) - len(s) - if indent >= 3 and s.startswith('```'): + cont = lines[i] + if not cont.strip(): + # blank — check if continuation follows + j = i + 1 + while j < len(lines) and not lines[j].strip(): + j += 1 + if j < len(lines): + cind = item_indent(lines[j]) if is_list_item(lines[j]) else (len(lines[j]) - len(lines[j].lstrip())) + if cind > base_indent: + i = j + continue + break + s = cont.lstrip() + cind = len(cont) - len(s) + if is_list_item(cont) and item_indent(cont) > base_indent: + nested_html, i = consume_list(lines, i, item_indent(cont)) + parts.append(nested_html) + elif is_list_item(cont) and item_indent(cont) == base_indent: + break + elif cind > base_indent and s.startswith('```'): ch, i = consume_code(lines, i) - extra.append(ch) - elif indent >= 3 and s.startswith('> '): - extra.append(f'
    {inline_format(s[2:])}
    ') - i += 1 - elif lines[i].strip() == '': + parts.append(ch) + elif cind > base_indent and s.startswith('> '): + parts.append(f'
    {inline_format(s[2:])}
    ') i += 1 - continue - elif indent >= 3 and s.strip(): - extra.append(inline_format(s)) + elif cind > base_indent and s.strip(): + parts.append(f'

    {inline_format(s)}

    ') i += 1 else: break - items.append(f'
  • {" ".join(extra) if item_html == "" else item_html}{"".join(extra) if item_html != "" else ""}
    • ') - # Fix the combine - combined = [] - for item in items: - combined.append(item) - html.append('
      \n' + '\n'.join(items) + '\n
    ') + # Close any open
  • + if parts and parts[-1] != f'<{tag}>': + parts.append('
    • ') + parts.append(f'') + return '\n'.join(parts), i + + if is_list_item(line): + base = item_indent(line) + list_html, i = consume_list(lines, i, base) + html.append(list_html) continue # Paragraph @@ -554,13 +580,17 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= }} .table-wrap {{ overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; }} .table-wrap table {{ + width: max-content; + min-width: 100%; margin-bottom: 0; }} .sidebar-content table {{ - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; }} .sidebar-content th {{ @@ -568,13 +598,13 @@ def make_page(title, body, slug, nav_template, footer_template, pages, is_index= text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; }} .sidebar-content td {{ padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; }} .sidebar-content img {{ max-width: 100%; border-radius: 8px; border: 1px solid var(--border); diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index 4398743..fabd304 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -465,17 +469,28 @@

    GKI Devices (Kernel 5.4 and up)

    Contribution guidelines

    To keep this list useful and reliable, please follow these rules when adding or updating entries:

      -
    • Add one device per row.
      • -
    • Fill every column completely.
      • -
    • Contributions should be honest, complete, and verifiable.
      • -
    • Provide a direct downloadable kernel archive (zip, tar, img) or a downloadable kernel package; inexperienced users should not need to compile the kernel themselves.
      • -
    • Provide the exact source code link for your Droidspaces kernel in the Kernel Source column.
      • -
    • Document the exact Baseband / Build string (Mandatory for Non-GKI devices only).
      • -
    • Specify the Root Method used, such as Magisk, KernelSU, APatch or none.(Compile only the kernel without adding any implementation methods; you need to patch init_boot yourself to achieve root.)
      • -
    • Set Status to one of: Working, Partial, or Unusable.
      • -
    • In Notes, include known quirks and issues, additional setup steps, and recommended workloads.
      • -
    • Submit contributions through GitHub pull requests.
      • -
    • Update entries when status changes, and keep the information current.
      • +
    • Add one device per row. +
      • +
    • Fill every column completely. +
      • +
    • Contributions should be honest, complete, and verifiable. +
      • +
    • Provide a direct downloadable kernel archive (zip, tar, img) or a downloadable kernel package; inexperienced users should not need to compile the kernel themselves. +
      • +
    • Provide the exact source code link for your Droidspaces kernel in the Kernel Source column. +
      • +
    • Document the exact Baseband / Build string (Mandatory for Non-GKI devices only). +
      • +
    • Specify the Root Method used, such as Magisk, KernelSU, APatch or none.(Compile only the kernel without adding any implementation methods; you need to patch init_boot yourself to achieve root.) +
      • +
    • Set Status to one of: Working, Partial, or Unusable. +
      • +
    • In Notes, include known quirks and issues, additional setup steps, and recommended workloads. +
      • +
    • Submit contributions through GitHub pull requests. +
      • +
    • Update entries when status changes, and keep the information current. +
    ← TroubleshootingGetting started with NixOS on Droidspaces →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index ee344b9..9b0ca44 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -394,80 +398,148 @@

    Cool Things You Can Do with Dro
    IMPORTANT This guide is specifically focused on Android devices. While Droidspaces also runs on Linux Desktop, these instructions address the unique networking, storage, and kernel requirements of the Android environment.

    Quick Navigation

    1. Setting Up a Secure "Mobile Server" (Tailscale + UFW + Fail2Ban)

    You can turn your Android device into a secure, accessible-from-anywhere Linux server by combining Droidspaces with Tailscale and standard Linux security tools.

    Prerequisites

      -
    • Kernel Support: This setup requires several Netfilter and IPSet modules. See Additional Kernel Configuration for UFW/Fail2ban for the full list of required options.
      • -
    • LTS Distribution: It is highly recommended to use a Long-Term Support (LTS) distribution like Ubuntu 24.04 LTS or Debian 12 for the best stability and package support.
      • -
    • Root User: All steps in this guide must be run as the root user inside the container.
      • -
    • Package Manager: The commands below use apt, which is only available in Debian and Ubuntu-based distributions.
      • -
    • NAT Mode: Mandatory. You must run your container in NAT mode (--net=nat). Using host networking while running a firewall like UFW can interfere with the Android host's connectivity, or it won't even work.
      • +
    • Kernel Support: This setup requires several Netfilter and IPSet modules. See Additional Kernel Configuration for UFW/Fail2ban for the full list of required options. +
      • +
    • LTS Distribution: It is highly recommended to use a Long-Term Support (LTS) distribution like Ubuntu 24.04 LTS or Debian 12 for the best stability and package support. +
      • +
    • Root User: All steps in this guide must be run as the root user inside the container. +
      • +
    • Package Manager: The commands below use apt, which is only available in Debian and Ubuntu-based distributions. +
      • +
    • NAT Mode: Mandatory. You must run your container in NAT mode (--net=nat). Using host networking while running a firewall like UFW can interfere with the Android host's connectivity, or it won't even work. +

    Step 1: Install Networking Tools & Compatibility Layer

    To handle firewall rules and network debugging, you first need to install the essential networking tools and ensure compatibility with the Android kernel.

      -
    1. Install tools:
      apt update && apt install -y net-tools iptables
-
      2. -
    2. Switch to Legacy iptables:Modern Ubuntu/Debian versions use the nftables backend by default, which often fails in Droidspaces containers on Android kernels. You must switch to the legacy iptables backend to ensure your firewall works:
      update-alternatives --set iptables /usr/sbin/iptables-legacy
+
    3. Install tools:
+
      apt update && apt install -y net-tools iptables
+
      
+
      4. 
+
    4. Switch to Legacy iptables:
+
      Modern Ubuntu/Debian versions use the nftables backend by default, which often fails in Droidspaces containers on Android kernels. You must switch to the legacy iptables backend to ensure your firewall works:
      
+
      update-alternatives --set iptables /usr/sbin/iptables-legacy
 update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
-
      5. 
+
      +

    Step 2: Personal User Setup & SSH Hardening

    To maintain a secure server, creating a dedicated user with sudo privileges and disabling direct root access over SSH is best practice.

      -
    1. Reclaim UID 1000: Linux distributions usually assign UID 1000 to the first non-root user (like ubuntu). To use this ID for your personal user, you should first detect and completely remove any existing UID 1000:
      # Identify and delete the default user associated with UID 1000
+
    2. Reclaim UID 1000: Linux distributions usually assign UID 1000 to the first non-root user (like ubuntu). To use this ID for your personal user, you should first detect and completely remove any existing UID 1000:
+
      # Identify and delete the default user associated with UID 1000
 DEFAULT_USER=$(getent passwd 1000 | cut -d: -f 1)
 userdel -r "$DEFAULT_USER"
 groupdel "$DEFAULT_USER" 2>/dev/null
-
      3. 
-
    3. Create your personal user as UID 1000 (Replace YOUR_USER with your desired username):
      useradd -m -u 1000 -s /bin/bash YOUR_USER
+
      
+
      4. 
+
    4. Create your personal user as UID 1000 (Replace YOUR_USER with your desired username):
+
      useradd -m -u 1000 -s /bin/bash YOUR_USER
 usermod -aG sudo YOUR_USER
 passwd YOUR_USER
-
      5. 
-
    5. Install OpenSSH Server:
      apt install -y openssh-server
-
      6. 
-
    6. Disable Root Login:Edit /etc/ssh/sshd_config to prevent direct root access:
      sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin no/' /etc/ssh/sshd_config
+
      
+
      7. 
+
    7. Install OpenSSH Server:
+
      apt install -y openssh-server
+
      
+
      8. 
+
    8. Disable Root Login:
+
      Edit /etc/ssh/sshd_config to prevent direct root access:
      
+
      sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin no/' /etc/ssh/sshd_config
 sed -i 's/PermitRootLogin yes/PermitRootLogin no/' /etc/ssh/sshd_config
 systemctl restart ssh
-
      9. 
+
      +

    Step 3: Set Up Tailscale

    Tailscale provides a secure P2P tunnel to your container, allowing you to access it from any device in your Tailnet without opening ports on your public router.

      -
    1. Install Tailscale:
      curl -fsSL https://tailscale.com/install.sh | sh
-
      2. -
    2. Authenticate:
      tailscale up
-
      3. +
    3. Install Tailscale: +
      curl -fsSL https://tailscale.com/install.sh | sh
+
      +
      4. +
    4. Authenticate: +
      tailscale up
+
      +

    Step 4: Secure the Container with UFW (Firewall)

    Since Droidspaces NAT mode currently only supports IPv4, we should disable IPv6 in UFW to avoid initialization errors.

      -
    1. Disable IPv6 in UFW:
      sed -i 's/IPV6=yes/IPV6=no/' /etc/default/ufw
-
      2. -
    2. Set Default Policies:
      ufw default deny incoming
+
    3. Disable IPv6 in UFW:
+
      sed -i 's/IPV6=yes/IPV6=no/' /etc/default/ufw
+
      
+
      4. 
+
    4. Set Default Policies:
+
      ufw default deny incoming
 ufw default allow outgoing
-
      5. 
-
    5. Whitelist the Tailscale Interface:Instead of whitelisting specific IP addresses, tell UFW to trust anything coming through your private Tailscale tunnel:
      ufw allow in on tailscale0
-
      6. 
-
    6. Enable the Firewall:
      ufw --force enable
-
      7. 
+
      +
      7. +
    7. Whitelist the Tailscale Interface: +

      Instead of whitelisting specific IP addresses, tell UFW to trust anything coming through your private Tailscale tunnel:

      +
      ufw allow in on tailscale0
+
      +
      8. +
    8. Enable the Firewall: +
      ufw --force enable
+
      +

    Step 5: Add Brute-Force Protection with Fail2Ban

    Fail2Ban monitors your system logs and automatically blocks IP addresses that show malicious behavior.

      -
    1. Install Fail2Ban:
      apt install -y fail2ban
-
      2. -
    2. Create a Local Configuration:Create a persistent configuration file at /etc/fail2ban/jail.local to protect SSH and integrate it with UFW:
      [DEFAULT]
+
    3. Install Fail2Ban:
+
      apt install -y fail2ban
+
      
+
      4. 
+
    4. Create a Local Configuration:
+
      Create a persistent configuration file at /etc/fail2ban/jail.local to protect SSH and integrate it with UFW:
      
+
      [DEFAULT]
 # Ban for 1 hour after 5 failed attempts within 10 minutes
 bantime  = 1h
 findtime = 10m
@@ -486,10 +558,13 @@ 
      Step 5: Add Brute-Force
 enabled = true
 port    = ssh
 backend = systemd
-
      5. 
-
    5. Start and Verify:
      systemctl restart fail2ban
+
      
+
      6. 
+
    6. Start and Verify:
+
      systemctl restart fail2ban
 fail2ban-client status sshd
-
      7. 
+
      +

    Your "Mobile Server" is now officially a hardened fortress! Anyone attempting to access it from the open internet will be blocked, while you maintain full access through your private Tailscale network.

    @@ -497,10 +572,18 @@

    2. Running Docker C

    Droidspaces supports running Docker natively inside your containers on all supported kernel versions. This allows you to run nested containerized services (like Portainer, Home Assistant, etc.) directly on your Android device.

    Prerequisites

      -
    • LTS Distribution: If your kernel version is less than 5.x.x, it is highly recommended to use an LTS distribution like Ubuntu 24.04 LTS for the best compatibility.
      • -
    • Kernel Configuration: Ensure your kernel has the required Droidspaces options enabled. See Required Kernel Configuration.
      • -
    • Storage Mode: You must use either ext4 /data or rootfs.img mode (recommended).- Why? Android's default f2fs filesystem does not support the overlay features required by Docker's overlay2 storage driver. Using a rootfs.img ensures you are running on a native ext4 filesystem.
      • -
    • NAT Mode: Mandatory. Docker requires NAT networking to create its internal docker0 bridge and provide internet access to nested containers.
      • +
    • LTS Distribution: If your kernel version is less than 5.x.x, it is highly recommended to use an LTS distribution like Ubuntu 24.04 LTS for the best compatibility. +
      • +
    • Kernel Configuration: Ensure your kernel has the required Droidspaces options enabled. See Required Kernel Configuration. +
      • +
    • Storage Mode: You must use either ext4 /data or rootfs.img mode (recommended). +
        +
      • Why? Android's default f2fs filesystem does not support the overlay features required by Docker's overlay2 storage driver. Using a rootfs.img ensures you are running on a native ext4 filesystem. +
        • +
      +
      • +
    • NAT Mode: Mandatory. Docker requires NAT networking to create its internal docker0 bridge and provide internet access to nested containers. +

    Step 1: Ensure NAT Networking

    diff --git a/docs/features.html b/docs/features.html index c453b57..78735a1 100644 --- a/docs/features.html +++ b/docs/features.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -412,9 +416,12 @@

    What Are Namespaces?

    Network Namespace Isolation (--net)

    Droidspaces supports three networking modes that determine whether a network namespace (CLONE_NEWNET) is used:

      -
    1. Host Mode (--net=host) - Default: Droidspaces deliberately does not unshare the network namespace. The container shares the host's network stack. This greatly simplifies setup: containers get internet access immediately without virtual bridges, NAT, or firewall rules. On Android, where networking is already complex (cellular, Wi-Fi, VPN), this avoids a whole category of connectivity issues.
      2. -
    2. NAT Mode (--net=nat): The container is placed in a private network namespace. It is connected to the host via a virtual bridge or veth pair, providing Pure Network Isolation while maintaining internet access through the host's upstream interfaces. Compatible with the vast majority of Android devices.
      3. -
    3. None Mode (--net=none): The container is placed in a private, air-gapped network namespace with only the loopback interface enabled for maximum security.
      4. +
    4. Host Mode (--net=host) - Default: Droidspaces deliberately does not unshare the network namespace. The container shares the host's network stack. This greatly simplifies setup: containers get internet access immediately without virtual bridges, NAT, or firewall rules. On Android, where networking is already complex (cellular, Wi-Fi, VPN), this avoids a whole category of connectivity issues. +
      5. +
    5. NAT Mode (--net=nat): The container is placed in a private network namespace. It is connected to the host via a virtual bridge or veth pair, providing Pure Network Isolation while maintaining internet access through the host's upstream interfaces. Compatible with the vast majority of Android devices. +
      6. +
    6. None Mode (--net=none): The container is placed in a private, air-gapped network namespace with only the loopback interface enabled for maximum security. +

    How It Compares to Chroot

    A chroot only changes the apparent root directory for a process. It provides no process isolation, no mount isolation, no hostname isolation, and no IPC isolation. Any process inside a chroot shares the host's PID space, can see and signal other processes, and cannot run an init system like systemd.

    @@ -425,27 +432,40 @@

    Why Init Systems Matter

    Without an init system, you're running individual processes in a chroot. You can't manage services, you can't use systemctl, you don't have journald for logging, and you don't have proper session management. It's a glorified shell.

    Droidspaces boots a real init system. When systemd starts as PID 1 inside the container:

      -
    • Services are managed via systemctl start/stop/enable
      • -
    • Logs are available via journalctl
      • -
    • User sessions work properly with login, su, and sudo
      • -
    • Targets and dependencies are resolved correctly
      • -
    • Timer units, socket activation, and all other systemd features work
      • +
    • Services are managed via systemctl start/stop/enable +
      • +
    • Logs are available via journalctl +
      • +
    • User sessions work properly with login, su, and sudo +
      • +
    • Targets and dependencies are resolved correctly +
      • +
    • Timer units, socket activation, and all other systemd features work +

    How Droidspaces Enables It

    Three things are required for systemd to function inside a container:

      -
    1. PID 1: The init process must be PID 1. Droidspaces achieves this with a PID namespace (CLONE_NEWPID) followed by a fork, making the container's init the first process in its namespace.
      2. -
    2. Container detection: Systemd needs to know it's running inside a container. Droidspaces writes droidspaces to /run/systemd/container and sets the container=droidspaces environment variable.
      3. -
    3. Cgroup access: Systemd requires write access to its cgroup hierarchy to create scopes and slices. Droidspaces provides this through per-container cgroup trees (see Cgroup Isolation).
      4. +
    4. PID 1: The init process must be PID 1. Droidspaces achieves this with a PID namespace (CLONE_NEWPID) followed by a fork, making the container's init the first process in its namespace. +
      5. +
    5. Container detection: Systemd needs to know it's running inside a container. Droidspaces writes droidspaces to /run/systemd/container and sets the container=droidspaces environment variable. +
      6. +
    6. Cgroup access: Systemd requires write access to its cgroup hierarchy to create scopes and slices. Droidspaces provides this through per-container cgroup trees (see Cgroup Isolation). +

    Supported Init Systems

    Droidspaces is theoretically compatible with any init system that can run as PID 1, including:

      -
    • systemd (most Linux distributions)
      • -
    • OpenRC (Alpine Linux, Gentoo)
      • -
    • runit (Void Linux, Devuan)
      • -
    • s6-init (Alpine, various containers)
      • -
    • SysVinit (Debian, Devuan)
      • +
    • systemd (most Linux distributions) +
      • +
    • OpenRC (Alpine Linux, Gentoo) +
      • +
    • runit (Void Linux, Devuan) +
      • +
    • s6-init (Alpine, various containers) +
      • +
    • SysVinit (Debian, Devuan) +

    The init binary is strictly expected at /sbin/init. If this binary is missing or not executable, Droidspaces will fail to boot the container to ensure that services and session management function as expected.

    @@ -455,17 +475,24 @@

    What Is Volatile Mode?

    How It Works

    Droidspaces uses OverlayFS, a union filesystem built into the Linux kernel:

      -
    • Lower layer: The original rootfs (mounted read-only if using the rootfs.img mode)
      • -
    • Upper layer: A tmpfs-backed directory that captures all writes
      • -
    • Merged view: The container sees a unified filesystem where reads come from the lower layer and writes go to the upper layer
      • +
    • Lower layer: The original rootfs (mounted read-only if using the rootfs.img mode) +
      • +
    • Upper layer: A tmpfs-backed directory that captures all writes +
      • +
    • Merged view: The container sees a unified filesystem where reads come from the lower layer and writes go to the upper layer +

    When the container stops, the upper layer (in RAM) is discarded. The original rootfs remains untouched.

    Use Cases

      -
    • Testing: Install packages, modify configurations, and verify changes without committing anything
      • -
    • Development: Spin up a clean environment for each build
      • -
    • Security: Guaranteed clean state on every boot
      • -
    • Experimentation: Break things without consequences
      • +
    • Testing: Install packages, modify configurations, and verify changes without committing anything +
      • +
    • Development: Spin up a clean environment for each build +
      • +
    • Security: Guaranteed clean state on every boot +
      • +
    • Experimentation: Break things without consequences +

    Usage

    # Volatile container from a directory
@@ -491,10 +518,14 @@ 
    The systemd 258+ Fix
    
 
    NOTE This information is based on current developer understanding of systemd's behavior in Droidspaces and may require further verification.
    
 
    Droidspaces handles this with a "dynamic hole-punching" technique:
    
 
      
-
    1. Pinning Subsystems: All /sys subdirectories are self-bind-mounted to preserve read-write access to individual hardware subsystems.
      2. 
-
    2. Read-Only Remount: The top-level /sys is remounted read-only.
      3. 
-
    3. Container Identification: systemd detects the read-only /sys, correctly identifies the container environment, and falls back to container-native console management.
      4. 
-
    4. Hardware Access: Individual hardware subsystems remain fully accessible via the pinned sub-mounts created in step 1.
      5. 
+
    5. Pinning Subsystems: All /sys subdirectories are self-bind-mounted to preserve read-write access to individual hardware subsystems.
+
      6. 
+
    6. Read-Only Remount: The top-level /sys is remounted read-only.
+
      7. 
+
    7. Container Identification: systemd detects the read-only /sys, correctly identifies the container environment, and falls back to container-native console management.
+
      8. 
+
    8. Hardware Access: Individual hardware subsystems remain fully accessible via the pinned sub-mounts created in step 1.
+
      9. 
 
    
 
    Usage
    
 
    droidspaces --name=gpu-test --rootfs=/path/to/rootfs --hw-access start
@@ -502,16 +533,21 @@ 
    Usage
    
 
    Automatic GPU Group Setup
    
 
    When --hw-access is enabled, Droidspaces automatically:
    
 
      
-
    1. Scans host GPU devices - Before pivot_root, it probes ~40 known GPU device paths (/dev/dri/*, /dev/mali*, /dev/kgsl-3d0, /dev/nvidia*, etc.) and collects their group IDs via stat(). Dangerous nodes like /dev/dri/card* are explicitly skipped to prevent host kernel panics, as these nodes are restricted to the host's display manager.
      2. 
-
    2. Creates matching groups - After pivot_root, it appends entries like gpu_:x::root to the container's /etc/group. The container's root user is automatically added to each group.
      3. 
-
    3. Idempotent restarts - On container restart, existing groups are detected and skipped (no duplicate entries).
      4. 
+
    4. Scans host GPU devices - Before pivot_root, it probes ~40 known GPU device paths (/dev/dri/*, /dev/mali*, /dev/kgsl-3d0, /dev/nvidia*, etc.) and collects their group IDs via stat(). Dangerous nodes like /dev/dri/card* are explicitly skipped to prevent host kernel panics, as these nodes are restricted to the host's display manager.
+
      5. 
+
    5. Creates matching groups - After pivot_root, it appends entries like gpu_:x::root to the container's /etc/group. The container's root user is automatically added to each group.
+
      6. 
+
    6. Idempotent restarts - On container restart, existing groups are detected and skipped (no duplicate entries).
+
      7. 
 
    
 
    This eliminates the need for manual groupadd/usermod commands inside the container, while ensuring the host's kernel stability by avoiding restricted hardware paths.
    
 
    X11 Socket Mounting
    
 
    For GUI application support, Droidspaces automatically bind-mounts the X11 socket directory:
    
 
      
-
    • Android (Termux X11): Detects and mounts /data/data/com.termux/files/usr/tmp/.X11-unix
      • 
-
    • Desktop Linux: Mounts /tmp/.X11-unix via /proc/1/root/tmp/.X11-unix
      • 
+
    • Android (Termux X11): Detects and mounts /data/data/com.termux/files/usr/tmp/.X11-unix
+
      • 
+
    • Desktop Linux: Mounts /tmp/.X11-unix via /proc/1/root/tmp/.X11-unix
+
      • 
 
    
 
    TIP X11 support can be enabled independently using the --termux-x11 (-X) flag. This is the recommended way to use GUI applications on Android if you do not need full GPU/hardware access, as it preserves a higher level of isolation.
    
 
    After starting the container, set DISPLAY=:0 inside the container to use the X11 display.
    
@@ -552,8 +588,10 @@ 
    Syntax
    
 
    
 
    Limits
    
 
      
-
    • Destination must be an absolute path
      • 
-
    • Path traversal (..) in destinations is rejected for security
      • 
+
    • Destination must be an absolute path
+
      • 
+
    • Path traversal (..) in destinations is rejected for security
+
      • 
 
    
 
    Automatic Directory Creation
    
 
    If the destination directory doesn't exist inside the rootfs, Droidspaces creates it automatically using mkdir -p.
    
@@ -595,10 +633,14 @@ 
    Why Use Images?
    
 
    How It Works
    
 
    When you use --rootfs-img:
    
 
      
-
    1. Filesystem check: Droidspaces runs e2fsck -f -y on the image to ensure integrity
      2. 
-
    2. SELinux context: On Android, applies the vold_data_file SELinux context to prevent silent I/O denials
      3. 
-
    3. Loop mount: The image is mounted at /mnt/Droidspaces/
      4. 
-
    4. Retry logic: On kernel 4.14, mounts may fail due to stale loop device state. Droidspaces retries up to 3 times with sync() and settle delays.
      5. 
+
    5. Filesystem check: Droidspaces runs e2fsck -f -y on the image to ensure integrity
+
      6. 
+
    6. SELinux context: On Android, applies the vold_data_file SELinux context to prevent silent I/O denials
+
      7. 
+
    7. Loop mount: The image is mounted at /mnt/Droidspaces/
+
      8. 
+
    8. Retry logic: On kernel 4.14, mounts may fail due to stale loop device state. Droidspaces retries up to 3 times with sync() and settle delays.
+
      9. 
 
    
 
    Usage
    
 
    # Image-based container (--name is mandatory)
@@ -620,8 +662,10 @@ 
    The "Jail" Trick
    
 
    Cgroup v1 and v2 Support
    
 
    Droidspaces supports both cgroup versions:
    
 
      
-
    • Cgroup v2 (unified): Used by modern distributions. Mounted as a single hierarchy.
      • 
-
    • Cgroup v1 (legacy): Used by older distributions. Droidspaces handles comounted controllers (e.g., cpu,cpuacct) and creates symlinks for secondary names in older kernels or --force-cgroupv1 mode.
      • 
+
    • Cgroup v2 (unified): Used by modern distributions. Mounted as a single hierarchy.
+
      • 
+
    • Cgroup v1 (legacy): Used by older distributions. Droidspaces handles comounted controllers (e.g., cpu,cpuacct) and creates symlinks for secondary names in older kernels or --force-cgroupv1 mode.
+
      • 
 
    
 
    Forcing Legacy Cgroup V1 (--force-cgroupv1)
    
 
    On legacy Android kernels (3.18, 4.4, or 4.9), the host system may either lack Cgroup v2 support entirely or provide a partial implementation without the essential controllers (CPU, memory, etc.) required by modern systemd. This inconsistency often causes systemd to misidentify the environment, leading to critical boot failures.
    
@@ -648,38 +692,53 @@ 
    Android-Specific Tuning
    
 
    1. Android Network & Hardware Groups
    
 
    Older Android kernels restrict network socket creation and direct hardware access to specific, hardcoded Group IDs (GIDs). Droidspaces maps and configures these groups inside the container's rootfs:
    
 
      
-
    • GID Mapping: Appends Android-specific groups to /etc/group:
      • 
-
    • aid_inet (3003): Allows internet access.
      • 
-
    • aid_net_raw (3004): Allows raw socket creation (e.g., for ping).
      • 
-
    • aid_net_admin (3005): Allows network administration.
      • 
-
    • Permissions Assignment: Adds the container's root user to the aid_inet, aid_net_raw, input, video, and tty groups.
      • 
-
    • Package Manager Fix: Configures the Debian/Ubuntu _apt user to use aid_inet as its primary group, allowing packages to be installed and updated without permission errors.
      • 
-
    • User Automation: Modifies /etc/adduser.conf so any newly created user automatically inherits these groups.
      • 
+
    • GID Mapping: Appends Android-specific groups to /etc/group:
+
        
+
      • aid_inet (3003): Allows internet access.
+
        • 
+
      • aid_net_raw (3004): Allows raw socket creation (e.g., for ping).
+
        • 
+
      • aid_net_admin (3005): Allows network administration.
+
        • 
+
      
+
      • 
+
    • Permissions Assignment: Adds the container's root user to the aid_inet, aid_net_raw, input, video, and tty groups.
+
      • 
+
    • Package Manager Fix: Configures the Debian/Ubuntu _apt user to use aid_inet as its primary group, allowing packages to be installed and updated without permission errors.
+
      • 
+
    • User Automation: Modifies /etc/adduser.conf so any newly created user automatically inherits these groups.
+
      • 
 
    
 
    2. Udev Trigger & Service Overrides
    
 
    Standard Linux distributions run udevadm trigger to coldplug hardware devices during boot. Triggering all subsystems simultaneously on an Android device can cause the kernel to panic.
    
 
      
-
    • Hardware Access Guards: Since udev services are only useful when hardware access is explicitly enabled, Droidspaces injects a drop-in ExecCondition override that prevents systemd-udevd.service, systemd-udev-trigger.service, and systemd-udev-settle.service from starting unless the container is configured with hardware access (enable_hw_access=1):
      • 
-
    
+
  • Hardware Access Guards: Since udev services are only useful when hardware access is explicitly enabled, Droidspaces injects a drop-in ExecCondition override that prevents systemd-udevd.service, systemd-udev-trigger.service, and systemd-udev-settle.service from starting unless the container is configured with hardware access (enable_hw_access=1):
 
    [Service]
 ExecCondition=
 ExecCondition=/bin/sh -c "grep -q 'enable_hw_access=1' /run/droidspaces/container.config"
 
    
-
      
-
    • Safe Udev Trigger: Instead of scanning everything, Droidspaces overrides the default systemd-udev-trigger.service using a drop-in configuration. If hardware access is enabled, this limits the trigger to a strictly defined, safe subset of subsystems:
      • 
-
    
+
    • 
+
  • Safe Udev Trigger: Instead of scanning everything, Droidspaces overrides the default systemd-udev-trigger.service using a drop-in configuration. If hardware access is enabled, this limits the trigger to a strictly defined, safe subset of subsystems:
 
    [Service]
 ExecStart=
 ExecStart=-/usr/bin/udevadm trigger --subsystem-match=usb --subsystem-match=block --subsystem-match=input --subsystem-match=tty --subsystem-match=net
 
    
-
      This allows the container to dynamically detect new USB drives, keyboards, and network interfaces without risking a host crash. - Read-Only Path Fix: Overrides ConditionPathIsReadWrite for all udev units to prevent failures in environments where key system directories are mounted read-only.
    
+
    This allows the container to dynamically detect new USB drives, keyboards, and network interfaces without risking a host crash.
    
+
    • 
+
  • Read-Only Path Fix: Overrides ConditionPathIsReadWrite for all udev units to prevent failures in environments where key system directories are mounted read-only.
+
    • 
+
 
    3. Optimizing systemd & Logging
    
 
    The Android kernel is notoriously verbose. Without tuning, standard journald setups would read host kernel messages and generate gigabytes of logs, quickly filling up the device's internal storage:
    
 
      
-
    • Journald Adjustments: Disables reading kernel messages and system auditing (ReadKMsg=no, Audit=no) in journald.conf to prevent the container from hoarding system-wide kernel logs.
      • 
-
    • Volatile Storage: Configures systemd journal logs to store in-memory only (Storage=volatile) and enforces strict maximum size constraints (200MB) to prevent constant writes from wearing out and filling the device's physical internal flash storage.
      • 
-
    • Service Masking: Masks systemd-networkd-wait-online.service to prevent boot delays, and systemd-journald-audit.socket to prevent systemd deadlocks in old kernels like 4.9.
      • 
-
    • Power Key Handling: Instructs systemd-logind to ignore host power and suspend key events so the container does not attempt to handle host power state transitions.
      • 
+
    • Journald Adjustments: Disables reading kernel messages and system auditing (ReadKMsg=no, Audit=no) in journald.conf to prevent the container from hoarding system-wide kernel logs.
+
      • 
+
    • Volatile Storage: Configures systemd journal logs to store in-memory only (Storage=volatile) and enforces strict maximum size constraints (200MB) to prevent constant writes from wearing out and filling the device's physical internal flash storage.
+
      • 
+
    • Service Masking: Masks systemd-networkd-wait-online.service to prevent boot delays, and systemd-journald-audit.socket to prevent systemd deadlocks in old kernels like 4.9.
+
      • 
+
    • Power Key Handling: Instructs systemd-logind to ignore host power and suspend key events so the container does not attempt to handle host power state transitions.
+
      • 
 
    
 
    4. NAT Mode Network Guards
    
 
    Under Host networking mode, running network managers like NetworkManager or systemd-networkd inside the container can conflict with the Android host's routing tables and break cellular/Wi-Fi connectivity.
    
@@ -690,8 +749,10 @@ 
    4. NAT Mode Network Guards
    
 
    
 
    5. Storage and DHCP Configuration
    
 
      
-
    • systemd-networkd Config: Automatically configures 10-eth-dhcp.network to enable DHCP and IPv6 route acceptance for any eth* interfaces.
      • 
-
    • Logrotate Limit: Enforces a maxsize 50M limit in /etc/logrotate.conf to prevent logs from consuming excessive disk space over time.
      • 
+
    • systemd-networkd Config: Automatically configures 10-eth-dhcp.network to enable DHCP and IPv6 route acceptance for any eth* interfaces.
+
      • 
+
    • Logrotate Limit: Enforces a maxsize 50M limit in /etc/logrotate.conf to prevent logs from consuming excessive disk space over time.
+
      • 
 
    
 
    ← Linux Installation GuideDroidspaces GPU Acceleration Guide →
    
       
    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors
diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html
index 5798ce0..cd30ff3 100644
--- a/docs/gpu-acceleration.html
+++ b/docs/gpu-acceleration.html
@@ -152,13 +152,17 @@
     }
     .table-wrap {
       overflow-x: auto;
+      -webkit-overflow-scrolling: touch;
       margin-bottom: 1.5rem;
     }
     .table-wrap table {
+      width: max-content;
+      min-width: 100%;
       margin-bottom: 0;
     }
     .sidebar-content table {
-      width: 100%; border-collapse: collapse; font-size: 0.85rem;
+      width: max-content; min-width: 100%;
+      border-collapse: collapse; font-size: 0.85rem;
       margin-bottom: 1.5rem;
     }
     .sidebar-content th {
@@ -166,13 +170,13 @@
       text-transform: uppercase; letter-spacing: 0.06em;
       padding: 0.75rem 1rem; text-align: left; color: var(--muted);
       border-bottom: 1px solid var(--border); background: var(--bg3);
-      white-space: normal;
-      word-break: break-word; overflow-wrap: anywhere;
+      white-space: nowrap;
     }
     .sidebar-content td {
       padding: 0.75rem 1rem; border-bottom: 1px solid var(--border);
       color: var(--muted);
-      word-break: break-word;
+      white-space: normal; word-break: normal;
+      overflow-wrap: break-word; max-width: 300px;
     }
     .sidebar-content img {
       max-width: 100%; border-radius: 8px; border: 1px solid var(--border);
@@ -394,8 +398,18 @@ 
    Droidspaces GPU Acceleration GuideThis guide provides step-by-step instructions for enabling GPU acceleration in your Droidspaces containers. Whether you are running on an Android device or a Linux desktop, Droidspaces offers multiple ways to leverage hardware acceleration for a smooth graphical experience.
    
 
    Quick Navigation
    
 
 
    
 
@@ -408,26 +422,40 @@ 
    01. Termux-X11 + llvmpipe
    
 
    The "Unified Tmpfs Bridge"
    
 
    When you enable the Termux X11 toggle in the Droidspaces app, the following sequence occurs:
    
 
      
-
    1. Host-side Preparation: Droidspaces creates a tmpfs mount on top of Termux's /data/data/com.termux/files/usr/tmp in the host's mount namespace.
      2. 
-
    2. Bypassing FBE Encryption: While a direct bind-mount of /data/data/com.termux/files/usr/tmp to the container is possible, it frequently breaks applications like apt or any tool performing heavy I/O in /tmp. This happens because Termux's data directory is protected by Android's File-Based Encryption (FBE), leading to "Required key not available" (ENOKEY) errors. By bridging the path via tmpfs, X11 sockets and temporary files become fully readable and writable by the container.
      3. 
-
    3. Bind Mounting: This "Unified Tmpfs Bridge" is then bind-mounted to the container's /tmp directory, enabling seamless communication between the container and the Termux-X11 app.
      4. 
+
    4. Host-side Preparation: Droidspaces creates a tmpfs mount on top of Termux's /data/data/com.termux/files/usr/tmp in the host's mount namespace.
+
      5. 
+
    5. Bypassing FBE Encryption: While a direct bind-mount of /data/data/com.termux/files/usr/tmp to the container is possible, it frequently breaks applications like apt or any tool performing heavy I/O in /tmp. This happens because Termux's data directory is protected by Android's File-Based Encryption (FBE), leading to "Required key not available" (ENOKEY) errors. By bridging the path via tmpfs, X11 sockets and temporary files become fully readable and writable by the container.
+
      6. 
+
    6. Bind Mounting: This "Unified Tmpfs Bridge" is then bind-mounted to the container's /tmp directory, enabling seamless communication between the container and the Termux-X11 app.
+
      7. 
 
    
 
    Setup Requirements
    
 
      
-
    • Termux: pkg install x11-repo && pkg install termux-x11
      • 
-
    • Container: sudo apt install mesa-utils (for testing with glxgears)
      • 
+
    • Termux: pkg install x11-repo && pkg install termux-x11
+
      • 
+
    • Container: sudo apt install mesa-utils (for testing with glxgears)
+
      • 
 
    
 
    Implementation Steps
    
 
      
-
    1. Configure Container: In the Droidspaces app, navigate to your container's configuration.
      2. 
-
    2. Enable X11: Toggle Termux-X11 to ON (Hardware Access is not required for software rendering).
      3. 
-
    3. Environment: Add DISPLAY=:0 to the Environment Variables section and save.
      4. 
-
    4. Start Container: Launch your container.
      5. 
-
    5. Launch X Server: Open the Termux app and run:
      termux-x11 :0
-
      6. 
-
    6. Verify: Run glxgears inside the container terminal. The output will render in the Termux-X11 app.
      7. 
-
    7. Start Desktop Environment: To launch the full XFCE desktop (if installed), run:
      dbus-launch --exit-with-session startxfce4
-
      8. 
+
    8. Configure Container: In the Droidspaces app, navigate to your container's configuration.
+
      9. 
+
    9. Enable X11: Toggle Termux-X11 to ON (Hardware Access is not required for software rendering).
+
      10. 
+
    10. Environment: Add DISPLAY=:0 to the Environment Variables section and save.
+
      11. 
+
    11. Start Container: Launch your container.
+
      12. 
+
    12. Launch X Server: Open the Termux app and run:
+
      termux-x11 :0
+
      
+
      13. 
+
    13. Verify: Run glxgears inside the container terminal. The output will render in the Termux-X11 app.
+
      14. 
+
    14. Start Desktop Environment: To launch the full XFCE desktop (if installed), run:
+
      dbus-launch --exit-with-session startxfce4
+
      
+
      15. 
 
    
 
    
 
@@ -435,22 +463,34 @@ 
    02. Termux-X11 + VirGL
    
 
    This method provides GPU acceleration for non-Qualcomm devices (Mali/PowerVR) via a virglrenderer bridge. It translates OpenGL calls from the container into commands that the host Android OS can execute.
    
 
    Setup Requirements
    
 
      
-
    • Termux: pkg install x11-repo && pkg install termux-x11 virglrenderer-android
      • 
-
    • Container: sudo apt install mesa-utils (for testing with glxgears)
      • 
+
    • Termux: pkg install x11-repo && pkg install termux-x11 virglrenderer-android
+
      • 
+
    • Container: sudo apt install mesa-utils (for testing with glxgears)
+
      • 
 
    
 
    Implementation Steps
    
 
      
-
    1. Container Configuration: Enable Termux-X11 in the Droidspaces container settings. Then, add the following to the Environment Variables section:
      DISPLAY=:0
+
    2. Container Configuration: Enable Termux-X11 in the Droidspaces container settings. Then, add the following to the Environment Variables section:
+
      DISPLAY=:0
 GALLIUM_DRIVER=virpipe
-
      3. 
-
    3. Start Container: Launch your container.
      4. 
-
    4. Start VirGL Server: Open Termux and run the server in the background:
      virgl_test_server_android &
-
      5. 
-
    5. Start X Server: In Termux, run:
      termux-x11 :0
-
      6. 
-
    6. Verify Acceleration: Run glxinfo -B and look for "VirGL" in the renderer string.
      7. 
-
    7. Start Desktop Environment: To launch the full XFCE desktop (if installed), run:
      dbus-launch --exit-with-session startxfce4
-
      8. 
+
      
+
      8. 
+
    8. Start Container: Launch your container.
+
      9. 
+
    9. Start VirGL Server: Open Termux and run the server in the background:
+
      virgl_test_server_android &
+
      
+
      10. 
+
    10. Start X Server: In Termux, run:
+
      termux-x11 :0
+
      
+
      11. 
+
    11. Verify Acceleration: Run glxinfo -B and look for "VirGL" in the renderer string.
+
      12. 
+
    12. Start Desktop Environment: To launch the full XFCE desktop (if installed), run:
+
      dbus-launch --exit-with-session startxfce4
+
      
+
      13. 
 
    
 
    TIP If the renderer fails to initialize, try starting the VirGL server with the Vulkan backend:
 virgl_test_server_android --angle-vulkan &
    
@@ -460,19 +500,36 @@ 
    03. Turnip (Native Qualcomm/Adreno)
    For Qualcomm Adreno GPUs, Droidspaces supports native hardware acceleration using the Turnip driver. This bypasses the need for virgl and provides near-native performance.
    
 
    Requirements
    
 
 
    Implementation Steps
    
 
      
-
    1. Install the custom Mesa driver from the Mesa for Android Container repository.
      2. 
-
    2. Enable GPU Access: In the container settings, enable GPU Access and Termux X11.
      3. 
-
    3. Set Display: Add DISPLAY=:0 to your environment variables.
      4. 
-
    4. Launch Sequence:- Start the container via Droidspaces.- Open Termux and run termux-x11 :0
      5. 
-
    5. Permission Management (Non-Root Users):If you are using a non-root user, you must grant them access to the GPU device nodes:
      sudo usermod -aG droidspaces-gpu 
-
      6. 
-
    6. Start Desktop Environment: To launch the full XFCE desktop (if installed), run:
      dbus-launch --exit-with-session startxfce4
-
      7. 
+
    7. Install the custom Mesa driver from the Mesa for Android Container repository.
+
      8. 
+
    8. Enable GPU Access: In the container settings, enable GPU Access and Termux X11.
+
      9. 
+
    9. Set Display: Add DISPLAY=:0 to your environment variables.
+
      10. 
+
    10. Launch Sequence:
+
        
+
      • Start the container via Droidspaces.
+
        • 
+
      • Open Termux and run termux-x11 :0
+
        • 
+
      
+
      11. 
+
    11. Permission Management (Non-Root Users):
+
      If you are using a non-root user, you must grant them access to the GPU device nodes:
      
+
      sudo usermod -aG droidspaces-gpu 
+
      
+
      12. 
+
    12. Start Desktop Environment: To launch the full XFCE desktop (if installed), run:
+
      dbus-launch --exit-with-session startxfce4
+
      
+
      13. 
 
    
 
    TIP If you encounter any problems related to DRI3, try editing /data/adb/modules/droidspaces/etc/droidspaces.te and uncommenting the line:
 allow untrusted_app_27 droidspacesd fd use
    
@@ -482,17 +539,25 @@ 
    Linux Desktop (AMD/Intel)
    
 
    On Linux-based hosts, GPU acceleration works natively with zero additional configuration within Droidspaces.
    
 
    Requirements
    
 
      
-
    • An active X11 or Wayland session on your host.
      • 
-
    • Functional GPU drivers (Mesa/Intel/AMD).
      • 
+
    • An active X11 or Wayland session on your host.
+
      • 
+
    • Functional GPU drivers (Mesa/Intel/AMD).
+
      • 
 
    
 
    Implementation Steps
    
 
      
-
    1. Enable Hardware Access: Ensure the Hardware Access toggle is enabled in your container configuration (or use the --hw-access CLI flag).
      2. 
-
    2. Xhost Permission: On your host machine, allow the container to connect to your X server:
      xhost +local:
-
      3. 
-
    3. Set Display Variable: Add the host's DISPLAY number to the container's environment (usually :0):
      echo "DISPLAY=:0" >> /etc/environment
-
      4. 
-
    4. Run Applications: GUI applications launched from the container will render natively with full hardware acceleration.
      5. 
+
    5. Enable Hardware Access: Ensure the Hardware Access toggle is enabled in your container configuration (or use the --hw-access CLI flag).
+
      6. 
+
    6. Xhost Permission: On your host machine, allow the container to connect to your X server:
+
      xhost +local:
+
      
+
      7. 
+
    7. Set Display Variable: Add the host's DISPLAY number to the container's environment (usually :0):
+
      echo "DISPLAY=:0" >> /etc/environment
+
      
+
      8. 
+
    8. Run Applications: GUI applications launched from the container will render natively with full hardware acceleration.
+
      9. 
 
    
 
    ← Feature Deep DivesKernel Configuration Guide →
    
       
    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors
diff --git a/docs/installation-android.html b/docs/installation-android.html
index bb2e62d..c9bc190 100644
--- a/docs/installation-android.html
+++ b/docs/installation-android.html
@@ -152,13 +152,17 @@
     }
     .table-wrap {
       overflow-x: auto;
+      -webkit-overflow-scrolling: touch;
       margin-bottom: 1.5rem;
     }
     .table-wrap table {
+      width: max-content;
+      min-width: 100%;
       margin-bottom: 0;
     }
     .sidebar-content table {
-      width: 100%; border-collapse: collapse; font-size: 0.85rem;
+      width: max-content; min-width: 100%;
+      border-collapse: collapse; font-size: 0.85rem;
       margin-bottom: 1.5rem;
     }
     .sidebar-content th {
@@ -166,13 +170,13 @@
       text-transform: uppercase; letter-spacing: 0.06em;
       padding: 0.75rem 1rem; text-align: left; color: var(--muted);
       border-bottom: 1px solid var(--border); background: var(--bg3);
-      white-space: normal;
-      word-break: break-word; overflow-wrap: anywhere;
+      white-space: nowrap;
     }
     .sidebar-content td {
       padding: 0.75rem 1rem; border-bottom: 1px solid var(--border);
       color: var(--muted);
-      word-break: break-word;
+      white-space: normal; word-break: normal;
+      overflow-wrap: break-word; max-width: 300px;
     }
     .sidebar-content img {
       max-width: 100%; border-radius: 8px; border: 1px solid var(--border);
@@ -394,34 +398,56 @@ 
    Android Installation Guide
    
 
    Droidspaces on Android is designed to be a "Zero Terminal" experience. From the first install to running a full Linux distribution, everything is handled through the intuitive Android app.
    
 
    Prerequisites
    
 
      
-
    1. Rooted device with supported rooting solutions from here
      2. 
-
    2. Compatible kernel with Droidspaces support enabled (see Kernel Configuration Guide)
      3. 
+
    3. Rooted device with supported rooting solutions from here
+
      4. 
+
    4. Compatible kernel with Droidspaces support enabled (see Kernel Configuration Guide)
+
      5. 
 
    
 
    Step 1: Install the App
    
 
      
-
    1. Download the Droidspaces APK from the latest release.
      2. 
-
    2. Install the APK on your device.
      3. 
-
    3. Grant root access and open the app.
      4. 
+
    4. Download the Droidspaces APK from the latest release.
+
      5. 
+
    5. Install the APK on your device.
+
      6. 
+
    6. Grant root access and open the app.
+
      7. 
 
    
 
    Step 2: Automatic Backend Setup
    
 
    On the first launch, Droidspaces performs an Atomic Installation of the backend system: - It detects your device architecture (aarch64, armhf, etc.). - It extracts the droidspaces and busybox binaries to /data/local/Droidspaces/bin. - It performs an atomic move to ensure the binaries are installed correctly even if an older version is currently running. - It verifies checksums to ensure zero corruption.
    
 
    Step 3: Setting Up Your First Container
    
 
    You don't need to manually extract rootfs files. The app handles it:
    
 
      
-
    1. Download a rootfs tarball: We recommend using our official rootfs tarballs - which are specifically optimized for Android - or the official Linux Containers images.
      2. 
-
    2. Open the Containers Tab: Tap the middle icon in the bottom navigation bar.
      3. 
-
    3. Add a Container: Tap the "+" button at the bottom right.
      4. 
-
    4. Choose your Tarball: Select the downloaded .tar.xz or .tar.gz file.
      5. 
-
    5. Configuration Wizard:- Name: Give your container a friendly name.- Features: Toggle Hardware Access, IPv6, Network Isolation, Android storage integration, etc., according to your needs.- Container Type: We recommend Sparse Image for better performance and stability on Android’s f2fs storage, as well as to prevent weird SELinux/Keyring issues.
      6. 
-
    6. Installation: The app will extract the tarball and apply Post-Extraction Fixes automatically (DNS, Masking useless/dangerous services, and Safe Udev).
      7. 
+
    7. Download a rootfs tarball: We recommend using our official rootfs tarballs - which are specifically optimized for Android - or the official Linux Containers images.
+
      8. 
+
    8. Open the Containers Tab: Tap the middle icon in the bottom navigation bar.
+
      9. 
+
    9. Add a Container: Tap the "+" button at the bottom right.
+
      10. 
+
    10. Choose your Tarball: Select the downloaded .tar.xz or .tar.gz file.
+
      11. 
+
    11. Configuration Wizard:
+
        
+
      • Name: Give your container a friendly name.
+
        • 
+
      • Features: Toggle Hardware Access, IPv6, Network Isolation, Android storage integration, etc., according to your needs.
+
        • 
+
      • Container Type: We recommend Sparse Image for better performance and stability on Android’s f2fs storage, as well as to prevent weird SELinux/Keyring issues.
+
        • 
+
      
+
      12. 
+
    12. Installation: The app will extract the tarball and apply Post-Extraction Fixes automatically (DNS, Masking useless/dangerous services, and Safe Udev).
+
      13. 
 
    
 
    Verification & Settings
    
 
    You can verify your system status at any time: 1. Go to Settings (gear icon) -> Requirements. 2. Tap Check Requirements. This runs the full droidspaces check suite internally. 3. Kernel Config: If you're a kernel developer, you can find a copyable droidspaces.config defconfig fragment, similar to this page, to make sure your kernel is perfectly compatible with Droidspaces.
    
 
    Next Steps
    
 
 
    Linux Installation Guide →
    
       
    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors
diff --git a/docs/installation-linux.html b/docs/installation-linux.html
index 16b63a6..48e4c91 100644
--- a/docs/installation-linux.html
+++ b/docs/installation-linux.html
@@ -152,13 +152,17 @@
     }
     .table-wrap {
       overflow-x: auto;
+      -webkit-overflow-scrolling: touch;
       margin-bottom: 1.5rem;
     }
     .table-wrap table {
+      width: max-content;
+      min-width: 100%;
       margin-bottom: 0;
     }
     .sidebar-content table {
-      width: 100%; border-collapse: collapse; font-size: 0.85rem;
+      width: max-content; min-width: 100%;
+      border-collapse: collapse; font-size: 0.85rem;
       margin-bottom: 1.5rem;
     }
     .sidebar-content th {
@@ -166,13 +170,13 @@
       text-transform: uppercase; letter-spacing: 0.06em;
       padding: 0.75rem 1rem; text-align: left; color: var(--muted);
       border-bottom: 1px solid var(--border); background: var(--bg3);
-      white-space: normal;
-      word-break: break-word; overflow-wrap: anywhere;
+      white-space: nowrap;
     }
     .sidebar-content td {
       padding: 0.75rem 1rem; border-bottom: 1px solid var(--border);
       color: var(--muted);
-      word-break: break-word;
+      white-space: normal; word-break: normal;
+      overflow-wrap: break-word; max-width: 300px;
     }
     .sidebar-content img {
       max-width: 100%; border-radius: 8px; border: 1px solid var(--border);
@@ -438,24 +442,36 @@ 
    Option A: Use a Directory Rootfs
    
 
 
    Encapsulating your rootfs in a single .img file provides better portability and avoids host filesystem conflicts.
    
 
      
-
    1. Create a sparse image file (e.g., 16GB):
      truncate -s 16G rootfs.img
-
      2. 
-
    2. Format it as ext4:
      mkfs.ext4 -L Droidspaces rootfs.img
-
      3. 
-
    3. Mount the image:
      mkdir -p rootfs_mount
+
    4. Create a sparse image file (e.g., 16GB):
+
      truncate -s 16G rootfs.img
+
      
+
      5. 
+
    5. Format it as ext4:
+
      mkfs.ext4 -L Droidspaces rootfs.img
+
      
+
      6. 
+
    6. Mount the image:
+
      mkdir -p rootfs_mount
 sudo mount rootfs.img rootfs_mount
-
      7. 
-
    7. Extract the rootfs tarball to the mountpoint:
      sudo tar -xvf /path/to/rootfs.tar.xz -C rootfs_mount
-
      8. 
-
    8. Unmount and clean up:
      sudo umount rootfs_mount
+
      
+
      9. 
+
    9. Extract the rootfs tarball to the mountpoint:
+
      sudo tar -xvf /path/to/rootfs.tar.xz -C rootfs_mount
+
      
+
      10. 
+
    10. Unmount and clean up:
+
      sudo umount rootfs_mount
 rmdir rootfs_mount
-
      11. 
+
      
+
      11. 
 
    
 
    Now you can boot it instantly using: sudo droidspaces --name=my-container --rootfs-img=rootfs.img start
    
 
    Next Steps
    
 
 
    ← Android Installation GuideFeature Deep Dives →
    
       
    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors
diff --git a/docs/kernel-configuration.html b/docs/kernel-configuration.html
index da22556..16f2417 100644
--- a/docs/kernel-configuration.html
+++ b/docs/kernel-configuration.html
@@ -152,13 +152,17 @@
     }
     .table-wrap {
       overflow-x: auto;
+      -webkit-overflow-scrolling: touch;
       margin-bottom: 1.5rem;
     }
     .table-wrap table {
+      width: max-content;
+      min-width: 100%;
       margin-bottom: 0;
     }
     .sidebar-content table {
-      width: 100%; border-collapse: collapse; font-size: 0.85rem;
+      width: max-content; min-width: 100%;
+      border-collapse: collapse; font-size: 0.85rem;
       margin-bottom: 1.5rem;
     }
     .sidebar-content th {
@@ -166,13 +170,13 @@
       text-transform: uppercase; letter-spacing: 0.06em;
       padding: 0.75rem 1rem; text-align: left; color: var(--muted);
       border-bottom: 1px solid var(--border); background: var(--bg3);
-      white-space: normal;
-      word-break: break-word; overflow-wrap: anywhere;
+      white-space: nowrap;
     }
     .sidebar-content td {
       padding: 0.75rem 1rem; border-bottom: 1px solid var(--border);
       color: var(--muted);
-      word-break: break-word;
+      white-space: normal; word-break: normal;
+      overflow-wrap: break-word; max-width: 300px;
     }
     .sidebar-content img {
       max-width: 100%; border-radius: 8px; border: 1px solid var(--border);
@@ -397,13 +401,20 @@ 
    Kernel Configuration Guide
    
 
    
 
    Quick Navigation
    
 
 
    
 
    Overview
    
@@ -522,9 +533,12 @@ 
    Step 3: Apply Patches

    Step 4: Build, Flash and Test

      -
    1. Save the configuration blocks above as .config fragments or merge them into your defconfig.
      2. -
    2. Compile and flash the kernel to your device.
      3. -
    3. Verify using the Droidspaces app Settings -> Requirements -> Check Requirements.
      4. +
    4. Save the configuration blocks above as .config fragments or merge them into your defconfig. +
      5. +
    5. Compile and flash the kernel to your device. +
      6. +
    6. Verify using the Droidspaces app Settings -> Requirements -> Check Requirements. +

    Configuring GKI Kernels

    @@ -535,18 +549,21 @@

    Step 1: Apply the Mandatory kAB
    IMPORTANT These patches are NOT OPTIONAL. You MUST apply the correct kABI fix patches for your kernel version. Skipping these patches will cause an immediate bootloop upon enabling CONFIG_SYSVIPC, CONFIG_IPC_NS or CONFIG_POSIX_MQUEUE.

    For ALL Kernels BELOW 6.12 (5.4, 5.10, 5.15, 6.1, 6.6):

    TIP The 001.GKI-below-6.12-fix_sysvipc_kABI_6_7_8.patch is recommended. If this patch causes a bootloop, try the alternative patches from the same folder (e.g., 1_2_3 or 3_4_5).

    For Kernels 5.10 and BELOW ONLY:

    -

    assets/resources/kernel-patches/GKI/below-kernel-6.12/002.5.10_or_lower_use_android_abi_padding_for_posix_mqueue.patch

    For Kernels 6.12 and ABOVE:

    How to apply the patches:

    # Apply each required patch for your kernel version
@@ -601,24 +618,37 @@ 
    Step 4: Flash and Test
    
 
    Testing Your Kernel
    
 
    1. Run the Requirements Check
    
 
      
-
    • In the app: Go to Settings (gear icon) -> Requirements -> Check Requirements.
      • 
-
    • In a terminal: Run:
      • 
+
    • In the app: Go to Settings (gear icon) -> Requirements -> Check Requirements.
+
      • 
+
    • In a terminal: Run:
+
      • 
 
    
 
    su -c droidspaces check
 
    
 
    This checks for:
    
 
      
-
    • Root access
      • 
-
    • Kernel version (minimum 3.18)
      • 
-
    • PID, MNT, UTS, IPC namespaces
      • 
-
    • Network namespace (optional, required for NAT/None modes)
      • 
-
    • Cgroup namespace (optional, for modern cgroup isolation)
      • 
-
    • devtmpfs support
      • 
-
    • OverlayFS support (optional, for volatile mode)
      • 
-
    • VETH and Bridge support (optional, for NAT mode)
      • 
-
    • PTY/devpts support
      • 
-
    • Loop device support
      • 
-
    • ext4 support
      • 
+
    • Root access
+
      • 
+
    • Kernel version (minimum 3.18)
+
      • 
+
    • PID, MNT, UTS, IPC namespaces
+
      • 
+
    • Network namespace (optional, required for NAT/None modes)
+
      • 
+
    • Cgroup namespace (optional, for modern cgroup isolation)
+
      • 
+
    • devtmpfs support
+
      • 
+
    • OverlayFS support (optional, for volatile mode)
+
      • 
+
    • VETH and Bridge support (optional, for NAT mode)
+
      • 
+
    • PTY/devpts support
+
      • 
+
    • Loop device support
+
      • 
+
    • ext4 support
+
      • 
 
    
 
    2. Understanding the Results

    @@ -668,16 +698,22 @@

    Nested Containers (Docker, Podman, LXC)

    Legacy Kernel Considerations (4.19 and below)

    Legacy kernels may present some challenges for modern nested container tools:

      -
    • Deadlock Shield trade-off: If your device is affected by the 4.14.113 grab_super() VFS deadlock and requires the Deadlock Shield to boot systemd, enabling the shield will also block the namespace syscalls that Docker, LXC, and Podman need. You cannot use nested containers while the shield is active.
      • -
    • Networking incompatibilities: Modern Docker, LXC, and Podman rely on nftables. Legacy kernels often lack full nftables support. To work around this, use Droidspaces in NAT mode and switch your container's iptables alternative to iptables-legacy and ip6tables-legacy.
      • -
    • BPF conflicts: Modern Docker and runc use BPF_CGROUP_DEVICE for device management. Legacy kernels do not support the required BPF attach types, which causes Invalid argument errors. To work around this, configure Docker to use the cgroupfs driver and the vfs storage driver.
      • +
    • Deadlock Shield trade-off: If your device is affected by the 4.14.113 grab_super() VFS deadlock and requires the Deadlock Shield to boot systemd, enabling the shield will also block the namespace syscalls that Docker, LXC, and Podman need. You cannot use nested containers while the shield is active. +
      • +
    • Networking incompatibilities: Modern Docker, LXC, and Podman rely on nftables. Legacy kernels often lack full nftables support. To work around this, use Droidspaces in NAT mode and switch your container's iptables alternative to iptables-legacy and ip6tables-legacy. +
      • +
    • BPF conflicts: Modern Docker and runc use BPF_CGROUP_DEVICE for device management. Legacy kernels do not support the required BPF attach types, which causes Invalid argument errors. To work around this, configure Docker to use the cgroupfs driver and the vfs storage driver. +

    Additional Resources

    ← Droidspaces GPU Acceleration GuideAndroid App Usage Guide →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors diff --git a/docs/linux-cli.html b/docs/linux-cli.html index b19a18b..bb7412b 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -630,9 +634,12 @@

    7. System Requirements

    Next Steps

    ← Android App Usage GuideCool Things You Can Do with Droidspaces →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index da0e823..11f4c40 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index d7790f3..737af75 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -394,22 +398,38 @@

    Troubleshooting

    Common issues, their causes, and how to fix them.

    Quick Navigation

    Modern Distros (Arch, Fedora, etc.) Failure on Legacy Kernels

    @@ -449,12 +469,18 @@

    Container Name Conflicts

    Symptoms: Starting a container fails because a container with the same name is already running, or PID file conflicts occur.

    Solution:

      -
    1. Check what's currently running:
      droidspaces show
-
      2. -
    2. If the container is listed but you believe it's actually stopped, clean up stale state:
      droidspaces scan
-
      3. -
    3. Use a different name:
      droidspaces --name=mycontainer-2 --rootfs=/path/to/rootfs start
-
      4. +
    4. Check what's currently running: +
      droidspaces show
+
      +
      5. +
    5. If the container is listed but you believe it's actually stopped, clean up stale state: +
      droidspaces scan
+
      +
      6. +
    6. Use a different name: +
      droidspaces --name=mycontainer-2 --rootfs=/path/to/rootfs start
+
      +

    Systemd Hangs on Older Kernels

    @@ -480,18 +506,22 @@

    Symptoms: You have no internet access inside the container. Even basic commands like ping fail immediately with a socket: permission denied error, even when running as root.

    Cause: This is caused by Android Paranoid Networking, a security feature found in many Android kernels (especially version 4.14 and older). Unlike standard Linux, the Android kernel restricts network socket creation to specific supplementary Group IDs (GIDs). Without these specific IDs, the kernel's security hooks block the process:

      -
    • AID_INET (3003): Required to create any AF_INET/AF_INET6 socket. Without this, connect() and bind() calls fail.
      • -
    • AID_NET_RAW (3004): Required for ping and other raw networking tasks.
      • -
    • AID_NET_ADMIN (3005): Required for network configuration and routing tasks.
      • +
    • AID_INET (3003): Required to create any AF_INET/AF_INET6 socket. Without this, connect() and bind() calls fail. +
      • +
    • AID_NET_RAW (3004): Required for ping and other raw networking tasks. +
      • +
    • AID_NET_ADMIN (3005): Required for network configuration and routing tasks. +

    Solutions:

      -
    • Kernel Level Fix: If you are building your own kernel, the most effective solution is to disable this restriction entirely in your kernel configuration:
      • -
    +
  • Kernel Level Fix: If you are building your own kernel, the most effective solution is to disable this restriction entirely in your kernel configuration: 
    CONFIG_ANDROID_PARANOID_NETWORK=n
    -
      -
    • Userland Fix: Use a rootfs that has been specifically patched to include these Android-specific GIDs in the group database. Our official rootfs tarballs come pre-configured to handle these permission requirements:Droidspaces-rootfs-builder Releases
      • + +
    • Userland Fix: Use a rootfs that has been specifically patched to include these Android-specific GIDs in the group database. Our official rootfs tarballs come pre-configured to handle these permission requirements: +

      Droidspaces-rootfs-builder Releases

      +

    DNS / Name Resolution Issues

    @@ -499,9 +529,12 @@

    DNS / Name Resolution Issues

    Cause: It seems some ISPs don’t like custom DNS setups. They completely block common DNS servers like 8.8.8.8 and 1.1.1.1.

    Solution: Use your ISP’s own DNS servers instead of custom ones.

      -
    1. Run this command in an Android root shell to get the default DNS addresses your ISP assigned:
      dumpsys connectivity | sed 's/}}/\n/g' | grep 'InterfaceName: wlan0' | grep -o 'DnsAddresses: \[[^]]*\]' | grep -o '/[0-9]*\.[0-9]*\.[0-9]*\.[0-9]*' | tr -d '/'
-
      2. -
    2. Add the results as DNS servers by editing the container configuration in the Droidspaces app.
      3. +
    3. Run this command in an Android root shell to get the default DNS addresses your ISP assigned: +
      dumpsys connectivity | sed 's/}}/\n/g' | grep 'InterfaceName: wlan0' | grep -o 'DnsAddresses: \[[^]]*\]' | grep -o '/[0-9]*\.[0-9]*\.[0-9]*\.[0-9]*' | tr -d '/'
+
      +
      4. +
    4. Add the results as DNS servers by editing the container configuration in the Droidspaces app. +

    WiFi/Mobile Data Disconnects

    @@ -509,9 +542,18 @@

    WiFi/Mobile Data Disconnects

    Cause: The container's systemd-networkd service may conflict with Android's network management or attempt to override host-side network configurations.

    Solutions:

      -
    • If you are using the host networking mode: Mask the systemd-networkd service inside the container to prevent it from starting:1. Via Android App: Go to Panel -> Container Name -> Manage (Systemd Menu) and find systemd-networkd, then tap on 3 dot icon next to the systemd-networkd card and select Mask.2. Via Terminal:
      sudo systemctl mask systemd-networkd
-
      • -
    • Use isolated NAT mode for maximum networking freedom without any conflicts to the host's networking.
      • +
    • If you are using the host networking mode: Mask the systemd-networkd service inside the container to prevent it from starting: +
        +
      1. Via Android App: Go to Panel -> Container Name -> Manage (Systemd Menu) and find systemd-networkd, then tap on 3 dot icon next to the systemd-networkd card and select Mask. +
        2. +
      2. Via Terminal: +
        sudo systemctl mask systemd-networkd
+
        +
        3. +
      +
      • +
    • Use isolated NAT mode for maximum networking freedom without any conflicts to the host's networking. +

    SELinux-Induced Rootfs Corruption (Directory Mode)

    @@ -527,10 +569,14 @@

    Systemd Service San

    Cause: Modern service files often use advanced systemd sandboxing directives (PrivateTmp, ProtectSystem, RestrictNamespaces). On legacy kernels (3.18 - 4.19), Droidspaces' Adaptive Seccomp Shield intercepts these namespace-related syscalls and returns EPERM to prevent kernel deadlocks. However, some distributions' versions of systemd treat these errors as fatal and refuse to start the service.

    Solution: Create a service override to disable the conflicting sandboxing features:

      -
    1. Identify the service: e.g., redis-server
      2. -
    2. Create the override:
      sudo systemctl edit 
-
      3. -
    3. Add these lines (to the empty space provided by the editor):
      [Service]
+
    4. Identify the service: e.g., redis-server
+
      5. 
+
    5. Create the override:
+
      sudo systemctl edit 
+
      
+
      6. 
+
    6. Add these lines (to the empty space provided by the editor):
+
      [Service]
 # Disable problematic security sandboxing
 PrivateTmp=no
 PrivateDevices=no
@@ -540,10 +586,13 @@ 
      Systemd Service San
 MemoryDenyWriteExecute=no
 NoNewPrivileges=no
 CapabilityBoundingSet=
-
      7. 
-
    7. Reload and restart:
      sudo systemctl daemon-reload
+
      
+
      8. 
+
    8. Reload and restart:
+
      sudo systemctl daemon-reload
 sudo systemctl restart 
-
      9. 
+
      +

    Reclaiming Storage (Sparse Image)

    @@ -551,10 +600,14 @@

    Reclaiming Storage (Sparse Image)

    Cause: Ext4 sparse images expand as you write data, but the host filesystem cannot automatically detect when blocks are freed inside the image. This is especially common on legacy kernels (e.g., 4.14).

    Solution: Use fstrim inside the container to tell the kernel to "discard" unused blocks, which punches holes in the sparse image and reclaims space on the physical disk.

      -
    1. Start the container normally.
      2. -
    2. Run fstrim as root inside the container:
      sudo fstrim -av
-
      3. -
    3. The command will report how many bytes were trimmed. You will notice the rootfs.img size on your Android storage has now decreased to match the actual data usage.
      4. +
    4. Start the container normally. +
      5. +
    5. Run fstrim as root inside the container: +
      sudo fstrim -av
+
      +
      6. +
    6. The command will report how many bytes were trimmed. You will notice the rootfs.img size on your Android storage has now decreased to match the actual data usage. +
    @@ -635,11 +688,16 @@

    3. Wire Up the Init Service

    Getting Help

    If your issue isn't listed here:

      -
    1. Run droidspaces check and note any failures
      2. -
    2. Check the container logs: droidspaces --name=mycontainer run journalctl -n 100
      3. -
    3. Try starting in foreground mode for more visibility: droidspaces --name=mycontainer --rootfs=/path/to/rootfs --foreground start
      4. -
    4. Join the Telegram channel for community support
      5. -
    5. Open an issue on the GitHub repository
      6. +
    6. Run droidspaces check and note any failures +
      7. +
    7. Check the container logs: droidspaces --name=mycontainer run journalctl -n 100 +
      8. +
    8. Try starting in foreground mode for more visibility: droidspaces --name=mycontainer --rootfs=/path/to/rootfs --foreground start +
      9. +
    9. Join the Telegram channel for community support +
      10. +
    10. Open an issue on the GitHub repository +
    ← Cool Things You Can Do with DroidspacesCommunity-supported Android devices →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors diff --git a/docs/uninstallation.html b/docs/uninstallation.html index 0976385..2abb0d8 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -396,23 +400,45 @@

    Uninstallation Guide

    Android (App)

    Follow these steps to ensure all container data and backend files are removed.

      -
    1. Stop Containers: Ensure all running containers are stopped from the Containers tab.
      2. -
    2. Delete Containers:- Go to the Containers tab.- Long-press each container card and select Uninstall Container. This deletes the rootfs image and its configuration.
      3. -
    3. Remove Backend Data:- Using a root file manager or a terminal (like Termux with root access), delete the following directory:
      su -c "rm -rf /data/local/Droidspaces"
-
      4. -
    4. Uninstall APK: Uninstall the Droidspaces app from your Android settings or launcher.
      5. -
    5. Reboot: Disable or remove the Magisk/KernelSU Droidspaces: Run-at-boot module from your root manager, then reboot to clear any remaining Droidspaces stuff.
      6. +
    6. Stop Containers: Ensure all running containers are stopped from the Containers tab. +
      7. +
    7. Delete Containers: +
        +
      • Go to the Containers tab. +
        • +
      • Long-press each container card and select Uninstall Container. This deletes the rootfs image and its configuration. +
        • +
      +
      8. +
    8. Remove Backend Data: +
        +
      • Using a root file manager or a terminal (like Termux with root access), delete the following directory: +
        • +
      +
      su -c "rm -rf /data/local/Droidspaces"
+
      +
      9. +
    9. Uninstall APK: Uninstall the Droidspaces app from your Android settings or launcher. +
      10. +
    10. Reboot: Disable or remove the Magisk/KernelSU Droidspaces: Run-at-boot module from your root manager, then reboot to clear any remaining Droidspaces stuff. +

    Linux (CLI)

      -
    1. Stop Containers: Stop all running containers.
      sudo droidspaces --name=web,db stop
-
      2. -
    2. Remove Filesystem: Delete the Droidspaces workspace directory. This will remove stale PID files, and logs.
      sudo rm -rf /var/lib/Droidspaces
-
      3. -
    3. Remove Binary: Delete the droidspaces binary.
      sudo rm /usr/local/bin/droidspaces
+
    4. Stop Containers: Stop all running containers.
+
      sudo droidspaces --name=web,db stop
+
      
+
      5. 
+
    5. Remove Filesystem: Delete the Droidspaces workspace directory. This will remove stale PID files, and logs.
+
      sudo rm -rf /var/lib/Droidspaces
+
      
+
      6. 
+
    6. Remove Binary: Delete the droidspaces binary.
+
      sudo rm /usr/local/bin/droidspaces
 # Or wherever you installed it
-
      7. 
+
      +
    ← Getting started with NixOS on Droidspaces

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index fe5cba5..0934515 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -152,13 +152,17 @@ } .table-wrap { overflow-x: auto; + -webkit-overflow-scrolling: touch; margin-bottom: 1.5rem; } .table-wrap table { + width: max-content; + min-width: 100%; margin-bottom: 0; } .sidebar-content table { - width: 100%; border-collapse: collapse; font-size: 0.85rem; + width: max-content; min-width: 100%; + border-collapse: collapse; font-size: 0.85rem; margin-bottom: 1.5rem; } .sidebar-content th { @@ -166,13 +170,13 @@ text-transform: uppercase; letter-spacing: 0.06em; padding: 0.75rem 1rem; text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); background: var(--bg3); - white-space: normal; - word-break: break-word; overflow-wrap: anywhere; + white-space: nowrap; } .sidebar-content td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); - word-break: break-word; + white-space: normal; word-break: normal; + overflow-wrap: break-word; max-width: 300px; } .sidebar-content img { max-width: 100%; border-radius: 8px; border: 1px solid var(--border); @@ -394,35 +398,49 @@

    Android App Usage Guide

    The Droidspaces Android app provides a premium GUI for managing Linux containers. It abstracts away the complexity of namespaces and mounts while giving you high-level control over your environments.

    Bottom Navigation

      -
    • Home: A dashboard displaying the number of installed and running containers, root availability status, and the backend version.
      • -
    • Containers: A dedicated manager for all installed containers (Install, Start, Stop, Edit, and Uninstall).
      • -
    • Panel: A central dashboard for managing Running Containers and monitoring real-time System Statistics (CPU, RAM, Temperature, etc.).
      • +
    • Home: A dashboard displaying the number of installed and running containers, root availability status, and the backend version. +
      • +
    • Containers: A dedicated manager for all installed containers (Install, Start, Stop, Edit, and Uninstall). +
      • +
    • Panel: A central dashboard for managing Running Containers and monitoring real-time System Statistics (CPU, RAM, Temperature, etc.). +

    Containers Tab

    This tab allows you to install containers using the "+" icon, and lists all your installed environments. Each container has a control card:

      -
    • Install Button (+): Install a new container.
      • -
    • Play Button: Start the container and boot the init system.
      • -
    • Stop Button: Sends a graceful shutdown signal to the container's init.
      • -
    • Cycle Button: Fast-restart the container.
      • -
    • Terminal Icon (Logs): Provides access to persistent session logs for the container's previous start, stop, and restart sequences.
      • +
    • Install Button (+): Install a new container. +
      • +
    • Play Button: Start the container and boot the init system. +
      • +
    • Stop Button: Sends a graceful shutdown signal to the container's init. +
      • +
    • Cycle Button: Fast-restart the container. +
      • +
    • Terminal Icon (Logs): Provides access to persistent session logs for the container's previous start, stop, and restart sequences. +
    TIP You can edit container configuration or uninstall existing installed containers by pressing and holding the container's card. Also gives you the ability to migrate to a rootfs.img-based container or resize your existing rootfs.img..!

    Networking Configuration

    When editing or creating a container, you can choose from three networking modes:

      -
    • Host (Default): Shares host network directly.
      • -
    • NAT (Isolated): Private network namespace with deterministic IP and port forwarding support.
      • -
    • None: No network access.
      • +
    • Host (Default): Shares host network directly. +
      • +
    • NAT (Isolated): Private network namespace with deterministic IP and port forwarding support. +
      • +
    • None: No network access. +

    Configuring Upstream Interfaces (NAT Mode)

    If you select NAT (Isolated) mode, you must specify one or more upstream interfaces for the container to have internet access. The app provides a convenient auto-detection workflow:

      -
    1. Detect Wi-Fi: Connect to your Wi-Fi network and press the refresh button in the "Upstream Interfaces" menu. Select the interface (usually wlan0) that appears.
      2. -
    2. Detect Mobile Data: Disable Wi-Fi and connect to mobile data. Press the refresh button again and select the mobile data interface (e.g., rmnet0, ccmni1).
      3. -
    3. Save: Both interfaces will now be used by the Route Monitor to keep your container connected as you switch networks.
      4. +
    4. Detect Wi-Fi: Connect to your Wi-Fi network and press the refresh button in the "Upstream Interfaces" menu. Select the interface (usually wlan0) that appears. +
      5. +
    5. Detect Mobile Data: Disable Wi-Fi and connect to mobile data. Press the refresh button again and select the mobile data interface (e.g., rmnet0, ccmni1). +
      6. +
    6. Save: Both interfaces will now be used by the Route Monitor to keep your container connected as you switch networks. +
    TIP You can manually enter wildcards in the Upstream Interfaces list (e.g., rmnet*) to ensure connectivity even if your carrier cycles through different interface names (like rmnet_data0 and rmnet_data1).
    NOTE NAT mode is IPv4 only. If your carrier only provides IPv6, see the IPv4 NAT Workaround.
    @@ -439,21 +457,32 @@

    Accessing the Container Shell

    Method 1: Built-in Terminal (v5.7.0+)

    This is the most convenient way to quickly run commands without leaving the Droidspaces app.

      -
    1. Ensure the container is RUNNING.
      2. -
    2. Navigate to the Panel tab and tap the container to open its Details.
      3. -
    3. Find the Terminal card and tap Open.
      4. -
    4. Select the User you wish to log in as (e.g., root or your default user).
      5. -
    5. An interactive terminal will launch directly within the app.
      6. +
    6. Ensure the container is RUNNING. +
      7. +
    7. Navigate to the Panel tab and tap the container to open its Details. +
      8. +
    8. Find the Terminal card and tap Open. +
      9. +
    9. Select the User you wish to log in as (e.g., root or your default user). +
      10. +
    10. An interactive terminal will launch directly within the app. +

    Method 2: External Terminal (Copy Login)

    For power users who prefer Termux, ADB, or other terminal emulators, Droidspaces allows you to "attach" external sessions to the container.

      -
    1. Ensure the container is RUNNING.
      2. -
    2. Open the container Details in the Panel tab.
      3. -
    3. Select your desired user from the dropdown menu.
      4. -
    4. Tap Copy Login. This copies a command like su -c 'droidspaces --name=[name enter [user]' to your clipboard.
      5. -
    5. Open your preferred terminal (e.g., Termux) and Paste the command.
      6. -
    6. Run the command (ensure your terminal has root permissions granted from your root manager).
      7. +
    7. Ensure the container is RUNNING. +
      8. +
    8. Open the container Details in the Panel tab. +
      9. +
    9. Select your desired user from the dropdown menu. +
      10. +
    10. Tap Copy Login. This copies a command like su -c 'droidspaces --name=[name enter [user]' to your clipboard. +
      11. +
    11. Open your preferred terminal (e.g., Termux) and Paste the command. +
      12. +
    12. Run the command (ensure your terminal has root permissions granted from your root manager). +

    Settings & Requirements

    diff --git a/downloads.html b/downloads.html index 10f17a7..895ceb8 100644 --- a/downloads.html +++ b/downloads.html @@ -123,80 +123,154 @@

    v6.2.0

    What's Changed

      -
    • fix(terminal): resolve hostname before opening tabs/picker (588cca1)
      • -
    • fix(terminal/panel): unified OSInfo stream eliminates hostname/metrics null bug (cb5cdd2)
      • -
    • droidspaces: bump v6.2.0 (823b889)
      • -
    • Translated using Weblate (#144) (4c37545)
      • -
    • fix: prevent UI remount and terminal state loss on screen rotation (cc491fd)
      • -
    • fix(service): update terminal session notification count and localize strings (f8088a5)
      • -
    • post_extract_fixes: configure systemd-networkd for eth0 and restrict network services to NAT mode via ExecCondition (2ae320c)
      • -
    • Merge branch 'dev' (16a7b39)
      • -
    • fix: correct banner printing order in start and restart flows (2b700a1)
      • -
    • app: scale up Ubuntu logo (6bb6669)
      • -
    • nix: modularize code, keep API intact, add pinned systemd v257, improve rootfs module (#143) (6e535c1)
      • -
    • app: add Azure icon support and map Azure and Mariner strings to IconUtils (b2ec2c6)
      • -
    • ui: Change default network mode to NAT and update static IP description (03c4bec)
      • -
    • socketd: preserve image-backed rootfs references in container summaries (#142) (b908c72)
      • -
    • config: implement semantic comparison to prevent redundant config writes (5ecb630)
      • -
    • Merge branch 'dev' (1363f5e)
      • -
    • Merge branch 'main' into dev (aa89854)
      • -
    • boot: guard UUID marker write against empty uuid (aba9b80)
      • -
    • app: preserve UUID across container config edits; parse uuid in parseConfig() (cf9cd1b)
      • -
    • pid: add collect_active_uuids(); container: skip generate_uuid() if existing UUID is collision-free (5fe67cc)
      • -
    • nix: add minimal-with-systemd-v257 (#141) (d20e6f1)
      • -
    • nix: fix android app drv that previously did not include binaries (#140) (f571bb2)
      • -
    • mount: skip tty1-N null symlinks in privileged+unfiltered-dev mode (b0acd95)
      • -
    • docs: update contributing guidelines to include Linux support, platform detection, and strict submission requirements (7a9e778)
      • -
    • docs: add CONTRIBUTING.md with project philosophy and submission guidelines (0d4d660)
      • -
    • seccomp: block host clock modification syscalls (39fb8de)
      • -
    • Merge branch 'main' into dev (f4c9277)
      • -
    • utils: harden init detection for Nix-based and wrapper-script rootfs (3ef14b2)
      • -
    • docs: we hit the 400KB binary size limit :( (b0f8ad5)
      • -
    • docs: added RISC-V 64 support to the supported architectures (4c045b9)
      • -
    • docs: remove deprecated UI credits for KernelSU-Next, MMRL, and LSPatch from README (68a873c)
      • -
    • docs: rewrote Droidspaces comparison sections into a comprehensive table against alternatives (1300228)
      • -
    • droidspaces.te: fixed a typo (5c4f40c)
      • -
    • Merge pull request #138 from yoshi3jp/web (8716a9c)
      • -
    • Translated using Weblate (Romanian) (#139) (3127eeb)
      • -
    • docs: add XFCE launch instructions and fix typos in SELinux policy documentation (e522f70)
      • -
    • nix: add nix documentation (#137) (2b19080)
      • -
    • socketd: replace snapshot dummies with backend-backed JSON projections (53df9e7)
      • -
    • socketd: add typed backend client methods for snapshot data (f99a8be)
      • -
    • socketd: add core lifecycle event journal and polling opcode (3e7ce18)
      • -
    • socketd: add backend pseudo-image inventory opcode (47be2d2)
      • -
    • socketd: add backend info counters for container inventory (c71485a)
      • -
    • socketd: implement backend container inventory opcode (93053ad)
      • -
    • Merge pull request #133 from yoshi3jp/web (cf823ca)
      • -
    • Merge branch 'main' into dev (4690c7f)
      • -
    • socketd: satisfy Portainer snapshot probes and expose local events (8d13720)
      • -
    • socketd: add dummy container list endpoint for Portainer probing (8f2baf4)
      • -
    • socketd: expose initial TCP Docker-compatible discovery API (709f5cd)
      • -
    • Translated using Weblate (Chinese (Simplified Han script)) (#136) (bf38753)
      • -
    • nix: ignore power/suspend key events in logind (#135) (9308fa2)
      • -
    • fixup boot module version and versionCode (2885999)
      • -
    • Nix: Fixing rootfs config, update nixpkgs, support for finix (#134) (347754e)
      • -
    • Web API skeleton (#132) (4131127)
      • -
    • fix(icons): clear OS info cache on container uninstall (1ccfc66)
      • -
    • feat(icons): prefetch distro icon on container start, cache forever, apply to all 3 card locations (141843e)
      • -
    • feat(ui): synchronize container installer options and enhance UI consistency (3e3b027)
      • -
    • ui: unify distro icon fetching and clear stale cache on stop/restart (f402152)
      • -
    • feat(ui): add custom icons for 22 popular Linux distributions in container details (cfe0c7e)
      • -
    • ui: fix real-time IP updates and prevent stale data display on restart (802524a)
      • -
    • virt: fix frozen/drifting uptime across all kernel versions (c04446c)
      • -
    • Merge branch 'main' into dev (b0871d5)
      • -
    • Translated using Weblate (Chinese (Traditional Han script)) (#131) (91089e6)
      • -
    • app: add support for configuring a custom init binary for containers (5a4cf94)
      • -
    • boot: add --init=PATH to override the default init binary (de4e15d)
      • -
    • virt: decouple resource visibility from cgroup limits (59160a4)
      • -
    • System-wide init family awareness (#129) (1660f6e)
      • -
    • Merge branch 'main' into dev (ff42b09)
      • -
    • cgroup: disable virtualization when controllers are unavailable (fe3553c)
      • -
    • feat: add [VIRT] prefix support to message logging filter (c455b09)
      • -
    • feat(virt): implement resource visibility virtualization (9802718)
      • -
    • cgroup: implement resource constraints via v2 delegation (84c4ca7)
      • -
    • [daemon] add optional backend bridge for future socket API service (#110) (59e53d6)
      • -
    • Add OnePlus SM8650(LineageOS) to community support devices list (#125) (e770d6f)
      • -
    • Add Nothing Phone (1) to supported devices list (#126) (f5b557e)
      • +
    • fix(terminal): resolve hostname before opening tabs/picker (588cca1) +
      • +
    • fix(terminal/panel): unified OSInfo stream eliminates hostname/metrics null bug (cb5cdd2) +
      • +
    • droidspaces: bump v6.2.0 (823b889) +
      • +
    • Translated using Weblate (#144) (4c37545) +
      • +
    • fix: prevent UI remount and terminal state loss on screen rotation (cc491fd) +
      • +
    • fix(service): update terminal session notification count and localize strings (f8088a5) +
      • +
    • post_extract_fixes: configure systemd-networkd for eth0 and restrict network services to NAT mode via ExecCondition (2ae320c) +
      • +
    • Merge branch 'dev' (16a7b39) +
      • +
    • fix: correct banner printing order in start and restart flows (2b700a1) +
      • +
    • app: scale up Ubuntu logo (6bb6669) +
      • +
    • nix: modularize code, keep API intact, add pinned systemd v257, improve rootfs module (#143) (6e535c1) +
      • +
    • app: add Azure icon support and map Azure and Mariner strings to IconUtils (b2ec2c6) +
      • +
    • ui: Change default network mode to NAT and update static IP description (03c4bec) +
      • +
    • socketd: preserve image-backed rootfs references in container summaries (#142) (b908c72) +
      • +
    • config: implement semantic comparison to prevent redundant config writes (5ecb630) +
      • +
    • Merge branch 'dev' (1363f5e) +
      • +
    • Merge branch 'main' into dev (aa89854) +
      • +
    • boot: guard UUID marker write against empty uuid (aba9b80) +
      • +
    • app: preserve UUID across container config edits; parse uuid in parseConfig() (cf9cd1b) +
      • +
    • pid: add collect_active_uuids(); container: skip generate_uuid() if existing UUID is collision-free (5fe67cc) +
      • +
    • nix: add minimal-with-systemd-v257 (#141) (d20e6f1) +
      • +
    • nix: fix android app drv that previously did not include binaries (#140) (f571bb2) +
      • +
    • mount: skip tty1-N null symlinks in privileged+unfiltered-dev mode (b0acd95) +
      • +
    • docs: update contributing guidelines to include Linux support, platform detection, and strict submission requirements (7a9e778) +
      • +
    • docs: add CONTRIBUTING.md with project philosophy and submission guidelines (0d4d660) +
      • +
    • seccomp: block host clock modification syscalls (39fb8de) +
      • +
    • Merge branch 'main' into dev (f4c9277) +
      • +
    • utils: harden init detection for Nix-based and wrapper-script rootfs (3ef14b2) +
      • +
    • docs: we hit the 400KB binary size limit :( (b0f8ad5) +
      • +
    • docs: added RISC-V 64 support to the supported architectures (4c045b9) +
      • +
    • docs: remove deprecated UI credits for KernelSU-Next, MMRL, and LSPatch from README (68a873c) +
      • +
    • docs: rewrote Droidspaces comparison sections into a comprehensive table against alternatives (1300228) +
      • +
    • droidspaces.te: fixed a typo (5c4f40c) +
      • +
    • Merge pull request #138 from yoshi3jp/web (8716a9c) +
      • +
    • Translated using Weblate (Romanian) (#139) (3127eeb) +
      • +
    • docs: add XFCE launch instructions and fix typos in SELinux policy documentation (e522f70) +
      • +
    • nix: add nix documentation (#137) (2b19080) +
      • +
    • socketd: replace snapshot dummies with backend-backed JSON projections (53df9e7) +
      • +
    • socketd: add typed backend client methods for snapshot data (f99a8be) +
      • +
    • socketd: add core lifecycle event journal and polling opcode (3e7ce18) +
      • +
    • socketd: add backend pseudo-image inventory opcode (47be2d2) +
      • +
    • socketd: add backend info counters for container inventory (c71485a) +
      • +
    • socketd: implement backend container inventory opcode (93053ad) +
      • +
    • Merge pull request #133 from yoshi3jp/web (cf823ca) +
      • +
    • Merge branch 'main' into dev (4690c7f) +
      • +
    • socketd: satisfy Portainer snapshot probes and expose local events (8d13720) +
      • +
    • socketd: add dummy container list endpoint for Portainer probing (8f2baf4) +
      • +
    • socketd: expose initial TCP Docker-compatible discovery API (709f5cd) +
      • +
    • Translated using Weblate (Chinese (Simplified Han script)) (#136) (bf38753) +
      • +
    • nix: ignore power/suspend key events in logind (#135) (9308fa2) +
      • +
    • fixup boot module version and versionCode (2885999) +
      • +
    • Nix: Fixing rootfs config, update nixpkgs, support for finix (#134) (347754e) +
      • +
    • Web API skeleton (#132) (4131127) +
      • +
    • fix(icons): clear OS info cache on container uninstall (1ccfc66) +
      • +
    • feat(icons): prefetch distro icon on container start, cache forever, apply to all 3 card locations (141843e) +
      • +
    • feat(ui): synchronize container installer options and enhance UI consistency (3e3b027) +
      • +
    • ui: unify distro icon fetching and clear stale cache on stop/restart (f402152) +
      • +
    • feat(ui): add custom icons for 22 popular Linux distributions in container details (cfe0c7e) +
      • +
    • ui: fix real-time IP updates and prevent stale data display on restart (802524a) +
      • +
    • virt: fix frozen/drifting uptime across all kernel versions (c04446c) +
      • +
    • Merge branch 'main' into dev (b0871d5) +
      • +
    • Translated using Weblate (Chinese (Traditional Han script)) (#131) (91089e6) +
      • +
    • app: add support for configuring a custom init binary for containers (5a4cf94) +
      • +
    • boot: add --init=PATH to override the default init binary (de4e15d) +
      • +
    • virt: decouple resource visibility from cgroup limits (59160a4) +
      • +
    • System-wide init family awareness (#129) (1660f6e) +
      • +
    • Merge branch 'main' into dev (ff42b09) +
      • +
    • cgroup: disable virtualization when controllers are unavailable (fe3553c) +
      • +
    • feat: add [VIRT] prefix support to message logging filter (c455b09) +
      • +
    • feat(virt): implement resource visibility virtualization (9802718) +
      • +
    • cgroup: implement resource constraints via v2 delegation (84c4ca7) +
      • +
    • [daemon] add optional backend bridge for future socket API service (#110) (59e53d6) +
      • +
    • Add OnePlus SM8650(LineageOS) to community support devices list (#125) (e770d6f) +
      • +
    • Add Nothing Phone (1) to supported devices list (#126) (f5b557e) +

    Automated Release by Droidspaces CI

    diff --git a/style.css b/style.css index c7b9413..109acd9 100644 --- a/style.css +++ b/style.css @@ -359,9 +359,14 @@ } /* COMPARISON TABLE */ - .table-wrap { overflow-x: auto; } + .table-wrap { overflow-x: auto; -webkit-overflow-scrolling: touch; } + .table-wrap table { + width: max-content; + min-width: 100%; + } table { - width: 100%; + width: max-content; + min-width: 100%; border-collapse: collapse; font-size: 0.85rem; } @@ -375,12 +380,17 @@ text-align: left; color: var(--muted); border-bottom: 1px solid var(--border); + white-space: nowrap; } th.hl { color: var(--accent2); } td { padding: 0.875rem 1rem; border-bottom: 1px solid var(--border); color: var(--muted); + white-space: normal; + word-break: normal; + overflow-wrap: break-word; + max-width: 300px; } td:first-child { font-weight: 500; From 6c8f73f1149d84560b005d954b23046e171d6905 Mon Sep 17 00:00:00 2001 From: TharukRenuja Date: Mon, 25 May 2026 13:22:55 +0530 Subject: [PATCH 13/22] Nuked ``Common Errors and Source Workflow Reference`` --- sitemap.xml | 6 ------ 1 file changed, 6 deletions(-) diff --git a/sitemap.xml b/sitemap.xml index ab5d3a2..3b6be08 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -66,12 +66,6 @@ monthly 0.6 - - https://www.droidspaces.org/docs/common-errors.html - 2026-05-23 - monthly - 0.6 - https://www.droidspaces.org/docs/troubleshooting.html 2026-05-23 From a08a01caf0d96926888a839f0e516b4753ed2760 Mon Sep 17 00:00:00 2001 From: ravindu644 Date: Wed, 27 May 2026 12:38:46 +0530 Subject: [PATCH 14/22] refactor: extract fetch_latest_release() from build_downloads_page also inject live version into index.html hero badge and JSON-LD Signed-off-by: ravindu644 Co-authored-by: TharukRenuja --- .github/scripts/build-docs.py | 95 ++++++++++++++++++++++++++--------- 1 file changed, 70 insertions(+), 25 deletions(-) diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index d0fb246..0513320 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -881,9 +881,7 @@ def fetch_kernel_patches(): parts.append('
    ') return '\n'.join(parts) -def build_downloads_page(root, nav_template, footer_template): - dl_nav = nav_template.replace('{{FEATURES_HREF}}', '/#features').replace('{{DOCS_STYLE}}', '') - releases = [] +def fetch_latest_release(): try: url = 'https://api.github.com/repos/ravindu644/Droidspaces-OSS/releases?per_page=5' req = urllib.request.Request(url) @@ -892,8 +890,55 @@ def build_downloads_page(root, nav_template, footer_template): req.add_header('Authorization', f'Bearer {token}') with urllib.request.urlopen(req, timeout=10) as resp: releases = json.loads(resp.read()) - except: - pass + except Exception: + return None + + if not releases: + return None + + latest = releases[0] + version = latest.get('tag_name', 'v6.2.0') + date = latest.get('published_at', '2026-05-22')[:10] + apk_url = '' + tar_url = '' + for a in latest.get('assets', []): + name = a.get('name', '') + if name.endswith('.apk'): + apk_url = a.get('browser_download_url', '') + elif name.endswith('.tar.gz'): + tar_url = a.get('browser_download_url', '') + body = latest.get('body', '') + changelog = md_to_html(body) if body else '

    No changelog available.

    ' + + older_rows = [] + for r in releases[1:]: + tag = r.get('tag_name', '') + rd = r.get('published_at', '')[:10] + rn = r.get('name', tag) + older_rows.append( + f'

    • ' + f'' + ) + older_html = ( + '
    {rn}{rd}Download
    ' + + '\n'.join(older_rows) + + '
    VersionDate
    ' + if older_rows else '' + ) + + return { + 'version': version, + 'date': date, + 'apk_url': apk_url, + 'tar_url': tar_url, + 'changelog': changelog, + 'older_html': older_html, + } + + +def build_downloads_page(root, nav_template, footer_template): + dl_nav = nav_template.replace('{{FEATURES_HREF}}', '/#features').replace('{{DOCS_STYLE}}', '') + release_info = fetch_latest_release() patches_html = '''

    GKI

    below-kernel-6.12

    ''' - if releases: - latest = releases[0] - version = latest.get('tag_name', 'v6.2.0') - date = latest.get('published_at', '2026-05-22')[:10] - apk_url = tar_url = '' - for a in latest.get('assets', []): - n = a['name'] - if n.endswith('.apk'): - apk_url = a['browser_download_url'] - elif n.endswith('.tar.gz'): - tar_url = a['browser_download_url'] - body = latest.get('body', '') - changelog = md_to_html(body) if body else '

    No changelog available.

    ' - older_rows = [] - for r in releases[1:]: - tag = r['tag_name'] - rd = r.get('published_at', '')[:10] - rn = r['name'] - older_rows.append(f'{rn}{rd}Download') - older_html = '
    ' + '\n'.join(older_rows) + '
    VersionDate
    ' if older_rows else '' + if release_info: + version = release_info['version'] + date = release_info['date'] + apk_url = release_info['apk_url'] + tar_url = release_info['tar_url'] + changelog = release_info['changelog'] + older_html = release_info['older_html'] else: version = 'v6.2.0' date = '2026-05-22' @@ -1126,6 +1158,19 @@ def generate_sitemap(root): index_html, flags=re.DOTALL ) + release_info = fetch_latest_release() + if release_info: + version = release_info['version'] + index_html = re.sub( + r'(
    )v[^<]+( · Open Source
    )', + lambda m: f'{m.group(1)}{version}{m.group(2)}', + index_html, + ) + index_html = re.sub( + r'("softwareVersion"\s*:\s*")v?[^"\n]+(",)', + lambda m: f'{m.group(1)}{version.lstrip("v")}{m.group(2)}', + index_html, + ) index_html = index_html.replace('{{FOOTER}}', footer_template) with open(index_path, 'w') as f: f.write(index_html) From 4efd44c2265f2a6f162132474071b0ecbfdb33cd Mon Sep 17 00:00:00 2001 From: ravindu644 Date: Wed, 27 May 2026 12:41:20 +0530 Subject: [PATCH 15/22] sitemap: remove common-errors.html entry Signed-off-by: ravindu644 --- .github/scripts/build-docs.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/scripts/build-docs.py b/.github/scripts/build-docs.py index 0513320..34ae247 100644 --- a/.github/scripts/build-docs.py +++ b/.github/scripts/build-docs.py @@ -1100,7 +1100,7 @@ def generate_sitemap(root): 'installation-android': 0.9, 'installation-linux': 0.8, 'features': 0.7, 'gpu-acceleration': 0.7, 'kernel-configuration': 0.7, 'usage-android-app': 0.7, 'linux-cli': 0.7, 'cool-things-you-can-do': 0.6, - 'common-errors': 0.6, 'troubleshooting': 0.6, 'community-supported-devices': 0.5, + 'troubleshooting': 0.6, 'community-supported-devices': 0.5, 'nix-nixos': 0.5, 'uninstallation': 0.5, } urls = [(loc, pri) for fname, (loc, pri) in priorities.items()] From de1b572547d6a74cc3f9096807eed28f789f83ec Mon Sep 17 00:00:00 2001 From: docs-bot Date: Wed, 27 May 2026 07:17:44 +0000 Subject: [PATCH 16/22] docs: update from source@921b99d --- docs/community-supported-devices.html | 28 +++++++++++++-------------- docs/cool-things-you-can-do.html | 20 +++++++++---------- docs/features.html | 20 +++++++++---------- docs/gpu-acceleration.html | 28 +++++++++++++-------------- docs/installation-android.html | 28 +++++++++++++-------------- docs/installation-linux.html | 28 +++++++++++++-------------- docs/kernel-configuration.html | 28 +++++++++++++-------------- docs/linux-cli.html | 28 +++++++++++++-------------- docs/nix-nixos.html | 28 +++++++++++++-------------- docs/troubleshooting.html | 20 +++++++++---------- docs/uninstallation.html | 28 +++++++++++++-------------- docs/usage-android-app.html | 28 +++++++++++++-------------- 12 files changed, 156 insertions(+), 156 deletions(-) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index fabd304..c47c49c 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -5,14 +5,14 @@ - Community-supported Android devices - Droidspaces Docs - + Community-Supported Android Devices - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Reference/Community-supported Android devices + Docs/Reference/Community-Supported Android Devices
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -492,7 +492,7 @@

    Contribution guidelines

  • Update entries when status changes, and keep the information current.
    • -
    ← TroubleshootingGetting started with NixOS on Droidspaces →
    +
    ← TroubleshootingNixOS on Droidspaces →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index 9b0ca44..0b2d797 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -630,7 +630,7 @@

    "Last Reso
    WARNING Above daemon.json configuration disables Docker's internal bridge (docker0) and all automatic port forwarding. You will only be able to run docker containers with internet with the --network host flag. eg: docker run -it --network host ubuntu
    -
    ← Linux CLI GuideTroubleshooting →
    +
    ← Linux CLITroubleshooting →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/features.html b/docs/features.html index 78735a1..4080e0d 100644 --- a/docs/features.html +++ b/docs/features.html @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -754,7 +754,7 @@

    5. Storage and DHCP Configuration

  • Logrotate Limit: Enforces a maxsize 50M limit in /etc/logrotate.conf to prevent logs from consuming excessive disk space over time.
    • -
    ← Linux Installation GuideDroidspaces GPU Acceleration Guide →
    +
    ← Linux InstallationGPU Acceleration →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index cd30ff3..f3d1549 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -5,14 +5,14 @@ - Droidspaces GPU Acceleration Guide - Droidspaces Docs - + GPU Acceleration - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Guides/Droidspaces GPU Acceleration Guide + Docs/Guides/GPU Acceleration
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -559,7 +559,7 @@

    Implementation Steps

  • Run Applications: GUI applications launched from the container will render natively with full hardware acceleration.
    • -
    ← Feature Deep DivesKernel Configuration Guide →
    +
    ← Feature Deep DivesKernel Configuration →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/installation-android.html b/docs/installation-android.html index c9bc190..a1f430c 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -5,14 +5,14 @@ - Android Installation Guide - Droidspaces Docs - + Android Installation - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Basics/Android Installation Guide + Docs/Basics/Android Installation
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -449,7 +449,7 @@

    Next Steps

  • Linux CLI Guide for expert command-line access.
    • -
    Linux Installation Guide →
    +
    Linux Installation →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/installation-linux.html b/docs/installation-linux.html index 48e4c91..d349ec4 100644 --- a/docs/installation-linux.html +++ b/docs/installation-linux.html @@ -5,14 +5,14 @@ - Linux Installation Guide - Droidspaces Docs - + Linux Installation - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Basics/Linux Installation Guide + Docs/Basics/Linux Installation
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -473,7 +473,7 @@

    Next Steps

  • Feature Deep Dives for detailed explanations of each feature
    • -
    ← Android Installation GuideFeature Deep Dives →
    +
    ← Android InstallationFeature Deep Dives →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/kernel-configuration.html b/docs/kernel-configuration.html index 16f2417..a57d51a 100644 --- a/docs/kernel-configuration.html +++ b/docs/kernel-configuration.html @@ -5,14 +5,14 @@ - Kernel Configuration Guide - Droidspaces Docs - + Kernel Configuration - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Guides/Kernel Configuration Guide + Docs/Guides/Kernel Configuration
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -715,7 +715,7 @@

    Additional Resources

  • Droidspaces Telegram Channel for kernel-specific support
    • -
    ← Droidspaces GPU Acceleration GuideAndroid App Usage Guide →
    +
    ← GPU AccelerationAndroid App Usage →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/linux-cli.html b/docs/linux-cli.html index bb7412b..e85ee1b 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -5,14 +5,14 @@ - Linux CLI Guide - Droidspaces Docs - + Linux CLI - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Guides/Linux CLI Guide + Docs/Guides/Linux CLI
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -641,7 +641,7 @@

    Next Steps

  • Android App Usage Guide
    • -
    ← Android App Usage GuideCool Things You Can Do with Droidspaces →
    +
    ← Android App UsageCool Things You Can Do with Droidspaces →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index 11f4c40..a1c5190 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -5,14 +5,14 @@ - Getting started with NixOS on Droidspaces - Droidspaces Docs - + NixOS on Droidspaces - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Reference/Getting started with NixOS on Droidspaces + Docs/Reference/NixOS on Droidspaces
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -427,7 +427,7 @@

    Finix (no more systemd) (experimenta

    To build a Finix tarball:

    nix build github:ravindu644/Droidspaces-OSS#finixDroidspacesTarballs.aarch64-linux.experimental
    -
    ← Community-supported Android devicesUninstallation Guide →
    +
    ← Community-Supported Android DevicesUninstallation →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index 737af75..dd1edba 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -699,7 +699,7 @@

    Getting Help

  • Open an issue on the GitHub repository
    • -
    ← Cool Things You Can Do with DroidspacesCommunity-supported Android devices →
    +
    ← Cool Things You Can Do with DroidspacesCommunity-Supported Android Devices →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/uninstallation.html b/docs/uninstallation.html index 2abb0d8..6785cf9 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -5,14 +5,14 @@ - Uninstallation Guide - Droidspaces Docs - + Uninstallation - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Reference/Uninstallation Guide + Docs/Reference/Uninstallation
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -440,7 +440,7 @@

    Linux (CLI)

    -
    ← Getting started with NixOS on Droidspaces
    +
    ← NixOS on Droidspaces

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index 0934515..82e03f0 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -5,14 +5,14 @@ - Android App Usage Guide - Droidspaces Docs - + Android App Usage - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Guides/Android App Usage Guide + Docs/Guides/Android App Usage
    @@ -369,16 +369,16 @@
    Basics
    -Android Installation Guide -Linux Installation Guide +Android Installation +Linux Installation
    Guides
    Feature Deep Dives -Droidspaces GPU Acceleration Guide -Kernel Configuration Guide -Android App Usage Guide -Linux CLI Guide +GPU Acceleration +Kernel Configuration +Android App Usage +Linux CLI
    Recipes
    @@ -387,9 +387,9 @@
    Reference
    Troubleshooting -Community-supported Android devices -Getting started with NixOS on Droidspaces -Uninstallation Guide +Community-Supported Android Devices +NixOS on Droidspaces +Uninstallation
    @@ -487,7 +487,7 @@

    Method 2: External Terminal (Copy

    Settings & Requirements

    Accessed via the gear icon in the top right: - Requirements: Runs a 27-point diagnostic check on your kernel. - Kernel Config: Provides a copyable droidspaces.config snippet specifically for your device. - Theme Engine: Support for AMOLED Black, Material You, Changing accent colors, and Light/Dark modes.

    -
    ← Kernel Configuration GuideLinux CLI Guide →
    +
    ← Kernel ConfigurationLinux CLI →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    From 6ec68766b554c78a40ef71d999a97e7c4b85b384 Mon Sep 17 00:00:00 2001 From: docs-bot Date: Wed, 27 May 2026 07:43:09 +0000 Subject: [PATCH 17/22] docs: update from source@62e6306 --- docs/community-supported-devices.html | 16 ++++++++-------- docs/cool-things-you-can-do.html | 14 +++++++------- docs/features.html | 6 +++--- docs/gpu-acceleration.html | 6 +++--- docs/installation-android.html | 6 +++--- docs/installation-linux.html | 6 +++--- docs/kernel-configuration.html | 6 +++--- docs/linux-cli.html | 8 ++++---- docs/nix-nixos.html | 16 ++++++++-------- docs/troubleshooting.html | 8 ++++---- docs/uninstallation.html | 8 ++++---- docs/usage-android-app.html | 6 +++--- 12 files changed, 53 insertions(+), 53 deletions(-) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index c47c49c..e27e7cc 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -5,14 +5,14 @@ - Community-Supported Android Devices - Droidspaces Docs - + Community-Supported Devices - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Reference/Community-Supported Android Devices + Docs/Reference/Community-Supported Devices
    @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    @@ -492,7 +492,7 @@

    Contribution guidelines

  • Update entries when status changes, and keep the information current.
    • -
    ← TroubleshootingNixOS on Droidspaces →
    +
    ← TroubleshootingNix/NixOS →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/cool-things-you-can-do.html b/docs/cool-things-you-can-do.html index 0b2d797..1288cc3 100644 --- a/docs/cool-things-you-can-do.html +++ b/docs/cool-things-you-can-do.html @@ -5,14 +5,14 @@ - Cool Things You Can Do with Droidspaces - Droidspaces Docs - + Cool Things You Can Do - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Recipes/Cool Things You Can Do with Droidspaces + Docs/Recipes/Cool Things You Can Do
    @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    diff --git a/docs/features.html b/docs/features.html index 4080e0d..47b36c4 100644 --- a/docs/features.html +++ b/docs/features.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index f3d1549..af69b8e 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    diff --git a/docs/installation-android.html b/docs/installation-android.html index a1f430c..63da90e 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    diff --git a/docs/installation-linux.html b/docs/installation-linux.html index d349ec4..525e446 100644 --- a/docs/installation-linux.html +++ b/docs/installation-linux.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    diff --git a/docs/kernel-configuration.html b/docs/kernel-configuration.html index a57d51a..9b9abbc 100644 --- a/docs/kernel-configuration.html +++ b/docs/kernel-configuration.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    diff --git a/docs/linux-cli.html b/docs/linux-cli.html index e85ee1b..34c4d39 100644 --- a/docs/linux-cli.html +++ b/docs/linux-cli.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    @@ -641,7 +641,7 @@

    Next Steps

  • Android App Usage Guide
    • -
    ← Android App UsageCool Things You Can Do with Droidspaces →
    +
    ← Android App UsageCool Things You Can Do →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/nix-nixos.html b/docs/nix-nixos.html index a1c5190..7713eda 100644 --- a/docs/nix-nixos.html +++ b/docs/nix-nixos.html @@ -5,14 +5,14 @@ - NixOS on Droidspaces - Droidspaces Docs - + Nix/NixOS - Droidspaces Docs + - + @@ -360,7 +360,7 @@ - Docs/Reference/NixOS on Droidspaces + Docs/Reference/Nix/NixOS
    @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    @@ -427,7 +427,7 @@

    Finix (no more systemd) (experimenta

    To build a Finix tarball:

    nix build github:ravindu644/Droidspaces-OSS#finixDroidspacesTarballs.aarch64-linux.experimental
    -
    ← Community-Supported Android DevicesUninstallation →
    +
    ← Community-Supported DevicesUninstallation →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index dd1edba..761504c 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    @@ -699,7 +699,7 @@

    Getting Help

  • Open an issue on the GitHub repository
    • -
    ← Cool Things You Can Do with DroidspacesCommunity-Supported Android Devices →
    +
    ← Cool Things You Can DoCommunity-Supported Devices →

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/uninstallation.html b/docs/uninstallation.html index 6785cf9..b3dc007 100644 --- a/docs/uninstallation.html +++ b/docs/uninstallation.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    @@ -440,7 +440,7 @@

    Linux (CLI)

    -
    ← NixOS on Droidspaces
    +
    ← Nix/NixOS

    © 2026 Droidspaces  ·  GPLv3  ·  by ravindu644 and contributors

    diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index 82e03f0..9e538ac 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -382,13 +382,13 @@
    Recipes
    -Cool Things You Can Do with Droidspaces +Cool Things You Can Do
    Reference
    Troubleshooting -Community-Supported Android Devices -NixOS on Droidspaces +Community-Supported Devices +Nix/NixOS Uninstallation
    From 352cf1d8cf7491c57dc938e41bef501450740aa6 Mon Sep 17 00:00:00 2001 From: docs-bot Date: Fri, 29 May 2026 09:30:34 +0000 Subject: [PATCH 18/22] docs: update from source@afb16a3 --- docs/installation-android.html | 28 ++++++++++++++++++++++------ docs/usage-android-app.html | 32 +++++++++++++++++++++++++++++++- 2 files changed, 53 insertions(+), 7 deletions(-) diff --git a/docs/installation-android.html b/docs/installation-android.html index 63da90e..f162019 100644 --- a/docs/installation-android.html +++ b/docs/installation-android.html @@ -415,15 +415,19 @@

    Step 1: Install the App

    Step 2: Automatic Backend Setup

    On the first launch, Droidspaces performs an Atomic Installation of the backend system: - It detects your device architecture (aarch64, armhf, etc.). - It extracts the droidspaces and busybox binaries to /data/local/Droidspaces/bin. - It performs an atomic move to ensure the binaries are installed correctly even if an older version is currently running. - It verifies checksums to ensure zero corruption.

    Step 3: Setting Up Your First Container

    -

    You don't need to manually extract rootfs files. The app handles it:

    +

    You don't need to manually extract rootfs files. The app handles it all.

    + +

    The easiest way to get started. The app can browse, download, and install distros directly - no manual downloading required.

      -
    1. Download a rootfs tarball: We recommend using our official rootfs tarballs - which are specifically optimized for Android - or the official Linux Containers images. -
    2. Open the Containers Tab: Tap the middle icon in the bottom navigation bar.
      3. -
    3. Add a Container: Tap the "+" button at the bottom right. +
    4. Open the Repository: Tap the cloud icon (above the "+" button). This opens the Rootfs Repository sheet, which automatically fetches all available distros optimized for Android from our official repository. +
      5. +
    5. Pick a distro: Browse or search the list. Each card shows the distro name, size, architecture, and build date.
      6. -
    6. Choose your Tarball: Select the downloaded .tar.xz or .tar.gz file. +
    7. Download: Tap Download on the distro you want. A progress bar appears on the card. The file saves to your Downloads folder. +
      8. +
    8. Install: Once complete, the button changes to Install. Tap it to launch the container setup wizard.
    9. Configuration Wizard:
        @@ -435,9 +439,21 @@

        Step 3: Setting Up Your First Co

      10. -
    10. Installation: The app will extract the tarball and apply Post-Extraction Fixes automatically (DNS, Masking useless/dangerous services, and Safe Udev). +
    11. Done: The app extracts the tarball and automatically applies Post-Extraction Fixes (DNS, masking useless/dangerous services, and Safe Udev). +
      12. +
    +
    TIP The official repository includes distros pre-configured for Android. For a wider selection, you can add the LXC images mirror as a custom repository - see the Rootfs Repository section of the Usage Guide.
    +

    Option B: Install from a Local Tarball

    +

    If you already have a .tar.xz or .tar.gz rootfs file on your device:

    +
      +
    1. Open the Containers Tab and tap the "+" button. +
      2. +
    2. Select your tarball from storage. +
      3. +
    3. Follow the same Configuration Wizard steps above.
    +
    NOTE Both methods lead to the same wizard - the only difference is where the tarball comes from.

    Verification & Settings

    You can verify your system status at any time: 1. Go to Settings (gear icon) -> Requirements. 2. Tap Check Requirements. This runs the full droidspaces check suite internally. 3. Kernel Config: If you're a kernel developer, you can find a copyable droidspaces.config defconfig fragment, similar to this page, to make sure your kernel is perfectly compatible with Droidspaces.

    Next Steps

    diff --git a/docs/usage-android-app.html b/docs/usage-android-app.html index 9e538ac..d614b33 100644 --- a/docs/usage-android-app.html +++ b/docs/usage-android-app.html @@ -420,7 +420,37 @@

    Containers Tab

  • Terminal Icon (Logs): Provides access to persistent session logs for the container's previous start, stop, and restart sequences.
    • -
    TIP You can edit container configuration or uninstall existing installed containers by pressing and holding the container's card. Also gives you the ability to migrate to a rootfs.img-based container or resize your existing rootfs.img..!
    +
    TIP You can edit container configuration or uninstall existing installed containers by pressing and holding the container’s card. Also gives you the ability to migrate to a rootfs.img-based container or resize your existing rootfs.img..!
    +
    +

    Rootfs Repository

    +

    The cloud icon above the "+" button opens the Rootfs Repository - a built-in distro browser that lets you download and install Linux rootfs images without leaving the app.

    +

    How it works

    +
      +
    1. Tap the cloud icon in the Containers tab. +
      2. +
    2. The sheet opens and loads available distros from the Droidspaces official repository. Only images matching your device’s architecture are shown. +
      3. +
    3. Search the list by name, description, or author using the search bar. +
      4. +
    4. Tap Download on a distro card. A progress bar tracks the download; the file is saved to your Downloads folder. +
      5. +
    5. Once done, the button switches to Install. Tap it to go straight into the container setup wizard. +
      6. +
    +
    NOTE If a download fails, the card shows a Retry button. Previously downloaded files are detected automatically on relaunch - the Install button will already be available.
    +

    Adding Custom Repositories

    +

    The repository supports third-party rootfs sources in the same JSON format.

    +
      +
    1. Tap the settings icon (left of the refresh icon) in the sheet header. +
      2. +
    2. Enter a name and a URL pointing to a valid rootfs.json. +
      3. +
    3. Tap Add, then Save. The sheet refreshes and merges results from all sources. +
      4. +
    +
    TIP To get a much wider selection of distros, add the official LXC images mirror as a custom repository: +- Name: anything you like (e.g. LXC Mirror) +- URL: https://raw.githubusercontent.com/Droidspaces/linuxcontainers-mirror/refs/heads/main/rootfs.json

    Networking Configuration

    When editing or creating a container, you can choose from three networking modes:

    From 255401d570301349902db738e53710c269d32791 Mon Sep 17 00:00:00 2001 From: docs-bot Date: Fri, 29 May 2026 09:35:05 +0000 Subject: [PATCH 19/22] docs: update from source@e64b269 --- docs/gpu-acceleration.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index af69b8e..cc9e7a4 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -415,7 +415,7 @@

    Quick Navigation

    Android

    Hardware acceleration on Android is achieved by bridging the container's graphics stack with a host-side X server (Termux-X11). Droidspaces handles the complex mount management and security contexts required to make this seamless.

    -
    TIP If you want to enjoy an out-of-the-box XFCE desktop environment experience, you can download our pre-configured XFCE tarballs from the official Droidspaces Rootfs Builder Releases.
    +
    TIP If you want to enjoy an out-of-the-box XFCE desktop environment experience, you can download our pre-configured XFCE tarballs from the Rootfs repository or from the official Droidspaces Rootfs Builder Releases.

    01. Termux-X11 + llvmpipe

    This method uses software rendering via llvmpipe. While it doesn't provide full hardware acceleration, it is the most stable way to run GUI applications when a compatible GPU driver isn't available.

    From a1b29baaf1bd1cbf33c9d6c007ce2dff999bf61f Mon Sep 17 00:00:00 2001 From: docs-bot Date: Sat, 30 May 2026 18:06:26 +0000 Subject: [PATCH 20/22] docs: update from source@a98bffd --- docs/community-supported-devices.html | 96 +++++++++++++++ docs/gpu-acceleration.html | 2 +- downloads.html | 164 +++++++++++++------------- index.html | 4 +- 4 files changed, 178 insertions(+), 88 deletions(-) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index e27e7cc..8f8ecbb 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -464,6 +464,102 @@

    GKI Devices (Kernel 5.4 and up)

    Redmi Note 13 4G / NFC23124RA7EOHyperOS 2.0 - Android 155.15.202Wild-KSU v3.1.2SourceDownloadBothTurnipWorking@superuseryuOther KSU variants may fail due to SELinux context reset. Nothing Phone (1)A063crDroid - Android 165.4.302KernelSU-NextSourceDownloadBothTurnip & VirglWorking@MySelly- Reno10 5GPHW110ColorOS15-16.1 - Android 15-165.4.254ReSukiSUSourceDownloadBothTurnipWorking@miaizhe- +OnePlus 10 ProNE2210, NE2211, NE2213, NE2215, NE2217Android 14 (OOS/COS 14)5.10.209KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 10 ProNE2210, NE2211, NE2213, NE2215, NE2217Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 10 ProNE2210, NE2211, NE2213, NE2215, NE2217Android 16 (OOS/COS 16)5.10.236KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 10RCPH2411Android 14 (OOS/COS 14)5.10.168KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 10RCPH2411Android 15 (OOS/COS 15)5.10.209KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 10TCPH2415, CPH2413, CPH2417, CPH2419Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 11PHB110, CPH2449, CPH2447, CPH2451Android 14 (OOS/COS 14)5.15.123KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 11PHB110, CPH2449, CPH2447, CPH2451Android 15 (OOS/COS 15)5.15.167KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 11PHB110, CPH2449, CPH2447, CPH2451Android 16 (OOS/COS 16)5.15.180KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 11RCPH2487Android 14 (OOS/COS 14)5.10.209KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 11RCPH2487Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 11RCPH2487Android 16 (OOS/COS 16)5.10.236KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 12PJD110, CPH2573, CPH2581, CPH2583Android 14 (OOS/COS 14)6.1.57KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 12PJD110, CPH2573, CPH2581, CPH2583Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 12PJD110, CPH2573, CPH2581, CPH2583Android 16 (OOS/COS 16)6.1.141KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 12RCPH2609, CPH2585, CPH2611Android 15 (OOS/COS 15)5.15.167KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 12RCPH2609, CPH2585, CPH2611Android 16 (OOS/COS 16)5.15.180KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13CPH2655, CPH2653, PJZ110, CPH2649Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13 CPHCPH2655, CPH2653, CPH2649Android 15 (OOS 15)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13 PJZPJZ110Android 15 (COS 15)6.6.66KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13RCPH2645, CPH2691, CPH2647Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13RCPH2645, CPH2691, CPH2647Android 16 (OOS/COS 16)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13SCPH2723Android 15 (OOS/COS 15)6.6.56KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13SCPH2723Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13TPKX110Android 15 (OOS/COS 15)6.6.66KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 13TPKX110Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 15CPH2747, CPH2745, PLK110, CPH2749Android 16 (OOS/COS 16)6.12.23KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 15RCPH2769, CPH2767Android 16 (OOS/COS 16)6.12.38KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus 15TPLZ110Android 16 (OOS/COS 16)6.12.38KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACEPGKM10Android 14 (OOS/COS 14)5.10.168KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACEPGKM10Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 2PHK110Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 2PHK110Android 16 (OOS/COS 16)5.10.236KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 2 ProPJA110Android 15 (OOS/COS 15)5.15.167KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 2 ProPJA110Android 16 (OOS/COS 16)5.15.180KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 2VPHP110Android 14 (OOS/COS 14)5.10.168KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 2VPHP110Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 2VPHP110Android 16 (OOS/COS 16)5.10.236KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 3PJE110Android 15 (OOS/COS 15)5.15.167KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 3PJE110Android 16 (OOS/COS 16)5.15.180KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 3 ProPJX110Android 14 (OOS/COS 14)6.1.75KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 3 ProPJX110Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 3 ProPJX110Android 16 (OOS/COS 16)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 3VPJF110Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 3VPJF110Android 16 (OOS/COS 16)6.1.141KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5PKG110Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5PKG110Android 16 (OOS/COS 16)6.1.141KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5 ProPKR110Android 15 (OOS/COS 15)6.6.66KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5 ProPKR110Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5 RacingPLF110Android 15 (OOS/COS 15)6.1.115KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5 RacingPLF110Android 16 (OOS/COS 16)6.1.134KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5 UltraPLC110Android 15 (OOS/COS 15)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 5 UltraPLC110Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 6PLQ110Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE 6TPLR110Android 16 (OOS/COS 16)6.12.38KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE RacePGZ110Android 14 (OOS/COS 14)5.10.168KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus ACE RacePGZ110Android 15 (OOS/COS 15)5.10.236KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 3CPH2491, CPH2493Android 14 (OOS/COS 14)5.10.198KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 3CPH2491, CPH2493Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 4CPH2663, CPH2661Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 4CPH2663, CPH2661Android 16 (OOS/COS 16)6.1.141KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 4 CECPH2613Android 15 (OOS/COS 15)5.15.180KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 4 CECPH2613Android 16 (OOS/COS 16)5.15.180KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 5CPH2709, CPH2707Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 5CPH2709, CPH2707Android 16 (OOS/COS 16)6.1.141KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord 6CPH2793, CPH2795Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord CE4 LiteCPH2619, CPH2621Android 15 (OOS/COS 15)6.1.75KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord CE4 LiteCPH2619, CPH2621Android 16 (OOS/COS 16)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord CE5CPH2719, CPH2717Android 15 (OOS/COS 15)6.1.115KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord CE5CPH2719, CPH2717Android 16 (OOS/COS 16)6.1.134KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Nord N30 SECPH2605Android 15 (OOS/COS 15)6.6.30KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus OpenCPH2551Android 15 (OOS/COS 15)5.15.167KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus OpenCPH2551Android 16 (OOS/COS 16)5.15.180KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 2 MT6991OPD2508Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 2 ProOPD2413Android 15 (OOS/COS 15)6.6.57KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 2 ProOPD2413Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 2 SM8650OPD2403Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 2 SM8650OPD2403Android 16 (OOS/COS 16)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 3 MT6897OPD2407Android 15 (OOS/COS 15)6.1.128KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 3 MT6897OPD2407Android 16 (OOS/COS 16)6.1.134KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 3 ProOPD2513Android 16 (OOS/COS 16)6.12.58KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 3 SM8750OPD2415Android 15 (OOS/COS 15)6.6.57KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 3 SM8750OPD2415Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad 4OPD2514Android 16 (OOS/COS 16)6.12.58KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad GoOPD2304, OPD2305Android 14 (OOS/COS 14)5.10.209KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad Go 2OPD2504, OPD2505Android 16 (OOS/COS 16)6.1.134KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad LiteOPD2480, OPD2481Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad LiteOPD2480, OPD2481Android 16 (OOS/COS 16)6.12.23KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad MT6983OPD2203Android 14 (OOS/COS 14)5.10.209KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad MT6983OPD2203Android 15 (OOS/COS 15)5.10.226KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad MT6983OPD2203Android 16 (OOS/COS 16)5.10.236KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad ProOPD2404Android 14 (OOS/COS 14)6.1.75KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad ProOPD2404Android 15 (OOS/COS 15)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Pad ProOPD2404Android 16 (OOS/COS 16)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Turbo 6PLU110Android 16 (OOS/COS 16)6.6.89KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support. +OnePlus Turbo 6VPLY110Android 16 (OOS/COS 16)6.1.118KernelSU Next + SusFSSourceDownloadBothTurnip & VirglWorking@fatalcoder524Check Latest Release Notes for more info and feature availability. Kernel versions can change for devices with active OTA support.

    Contribution guidelines

    diff --git a/docs/gpu-acceleration.html b/docs/gpu-acceleration.html index cc9e7a4..1e3daeb 100644 --- a/docs/gpu-acceleration.html +++ b/docs/gpu-acceleration.html @@ -531,7 +531,7 @@

    Implementation Steps

    -
    TIP If you encounter any problems related to DRI3, try editing /data/adb/modules/droidspaces/etc/droidspaces.te and uncommenting the line: +
    TIP If you encounter any problems related to DRI3, try editing /data/adb/modules/droidspaces/sepolicy.rule and uncommenting the line: allow untrusted_app_27 droidspacesd fd use
    diff --git a/downloads.html b/downloads.html index 895ceb8..2c31618 100644 --- a/downloads.html +++ b/downloads.html @@ -70,20 +70,20 @@
    Downloads
    -

    v6.2.0

    -

    Released Date: 2026-05-22

    +

    v6.2.5

    +

    Released Date: 2026-05-29

    Android

    APK for rooted Android devices. KernelSU, Magisk, or APatch.

    - Download APK + Download APK

    Linux

    Static tarball for any Linux distribution. Zero dependencies.

    - Download Tarball + Download Tarball
    @@ -118,158 +118,152 @@

    Download kernel patches

    Changelog
    -

    v6.2.0

    +

    v6.2.5

    What's Changed

      -
    • fix(terminal): resolve hostname before opening tabs/picker (588cca1) +
    • fix: bump boot module version to v6.2.5 (65e8011)
      • -
    • fix(terminal/panel): unified OSInfo stream eliminates hostname/metrics null bug (cb5cdd2) +
    • docs: update XFCE tarball resource links and fix formatting for DRI3 tip (e64b269)
      • -
    • droidspaces: bump v6.2.0 (823b889) +
    • docs: update installation and usage guides to include Rootfs Repository features (afb16a3)
      • -
    • Translated using Weblate (#144) (4c37545) +
    • docs: update gallery and showcase screenshots in readme (8c2be2d)
      • -
    • fix: prevent UI remount and terminal state loss on screen rotation (cc491fd) +
    • droidspaces: v6.2.5 (be2dbc2)
      • -
    • fix(service): update terminal session notification count and localize strings (f8088a5) +
    • Translated using Weblate (#165) (0efdc4c)
      • -
    • post_extract_fixes: configure systemd-networkd for eth0 and restrict network services to NAT mode via ExecCondition (2ae320c) +
    • seccomp: drop mknod/mknodat device blocking (580c1ea)
      • -
    • Merge branch 'dev' (16a7b39) +
    • post_extract_fixes: generate and set machine-id to prevent systemd deadlocks on Fedora 44 (8645ce1)
      • -
    • fix: correct banner printing order in start and restart flows (2b700a1) +
    • post_extract_fixes: remove problematic iptables service files (2a30f3c)
      • -
    • app: scale up Ubuntu logo (6bb6669) +
    • Add conditional compilation for ds_socketd_record_core_event (924a3c1)
      • -
    • nix: modularize code, keep API intact, add pinned systemd v257, improve rootfs module (#143) (6e535c1) +
    • build: reduce R8 obfuscation to lower AV heuristic score (8de6bcc)
      • -
    • app: add Azure icon support and map Azure and Mariner strings to IconUtils (b2ec2c6) +
    • fix: declare BootReceiver to satisfy RECEIVE_BOOT_COMPLETED permission (9d1ff64)
      • -
    • ui: Change default network mode to NAT and update static IP description (03c4bec) +
    • fix: remove shadowed context variable in ContainerCard (1be8b50)
      • -
    • socketd: preserve image-backed rootfs references in container summaries (#142) (b908c72) +
    • docs: zh-CN: move language switcher to the top of README (01ff26c)
      • -
    • config: implement semantic comparison to prevent redundant config writes (5ecb630) +
    • fix: distro icons disappearing after app kill (d9d6bd5)
      • -
    • Merge branch 'dev' (1363f5e) +
    • mount: fix /proc/sys RW holes being clobbered by parent RO lock (2c1cf81)
      • -
    • Merge branch 'main' into dev (aa89854) +
    • refactor: rename clean_kmsg.txt to last_kmsg.txt for consistency in bug report collection (7291aa3)
      • -
    • boot: guard UUID marker write against empty uuid (aba9b80) +
    • daemon: add mid-run log rotation for droidspacesd.log (3805da1)
      • -
    • app: preserve UUID across container config edits; parse uuid in parseConfig() (cf9cd1b) +
    • ds_dhcp: fix cross-container DHCP leaks with ifindex and direction filtering (7964783)
      • -
    • pid: add collect_active_uuids(); container: skip generate_uuid() if existing UUID is collision-free (5fe67cc) +
    • style: enforce consistent code formatting using clang-format across source files (fffaa78)
      • -
    • nix: add minimal-with-systemd-v257 (#141) (d20e6f1) +
    • build: fix all hardened-debug compiler warnings (f1ae0ef)
      • -
    • nix: fix android app drv that previously did not include binaries (#140) (f571bb2) +
    • log: persist container logging across pivot_root isolation (ba51ef9)
      • -
    • mount: skip tty1-N null symlinks in privileged+unfiltered-dev mode (b0acd95) +
    • virtualize.c: add pre-check to skip virtualization updates if tmpfs directory is missing (2c2b6bf)
      • -
    • docs: update contributing guidelines to include Linux support, platform detection, and strict submission requirements (7a9e778) +
    • mount: unify masking as self-bind+RO, drop unused shared mask-dir tmpfs (29ae5da)
      • -
    • docs: add CONTRIBUTING.md with project philosophy and submission guidelines (0d4d660) +
    • feat: wire read-only bind mount flag to app (9c60d95)
      • -
    • seccomp: block host clock modification syscalls (39fb8de) +
    • mount: add :ro flag support for read-only bind mounts (7b97ff3)
      • -
    • Merge branch 'main' into dev (f4c9277) +
    • Translated using Weblate (#163) (b615530)
      • -
    • utils: harden init detection for Nix-based and wrapper-script rootfs (3ef14b2) +
    • More Shortened titles in Docs metadata (#162) (62e6306)
      • -
    • docs: we hit the 400KB binary size limit :( (b0f8ad5) +
    • Shortened titles in Docs metadata (#161) (921b99d)
      • -
    • docs: added RISC-V 64 support to the supported architectures (4c045b9) +
    • docs: move language switcher to the top of README (eb721a0)
      • -
    • docs: remove deprecated UI credits for KernelSU-Next, MMRL, and LSPatch from README (68a873c) +
    • post_extract_fixes: do not add ExecCondition to udev-related units (136ec2f)
      • -
    • docs: rewrote Droidspaces comparison sections into a comprehensive table against alternatives (1300228) +
    • fix: post_extract_fixes: guard udev socket units with hardware access limit (0d504ad)
      • -
    • droidspaces.te: fixed a typo (5c4f40c) +
    • ui: polish rootfs repository sheet and fix cosmetic bugs (a3cdcec)
      • -
    • Merge pull request #138 from yoshi3jp/web (8716a9c) +
    • Update translation files (#157) (2bbe25c)
      • -
    • Translated using Weblate (Romanian) (#139) (3127eeb) +
    • app: Rootfs Repository: use unique, metadata-derived filenames for rootfs assets to prevent download conflicts (c73586d)
      • -
    • docs: add XFCE launch instructions and fix typos in SELinux policy documentation (e522f70) +
    • Android: fix icon cache poisoning and stale state after container poweroff (b626078)
      • -
    • nix: add nix documentation (#137) (2b19080) +
    • seccomp: truly skip all filters when noseccomp is active (0ea180e)
      • -
    • socketd: replace snapshot dummies with backend-backed JSON projections (53df9e7) +
    • nix: finix: fix finix using wrong arch. improve compatibility with droidspaces (#159) (01ce155)
      • -
    • socketd: add typed backend client methods for snapshot data (f99a8be) +
    • docs: zh-CN: consolidate Simplified Chinese translations into singular folder (a5746c7)
      • -
    • socketd: add core lifecycle event journal and polling opcode (3e7ce18) +
    • Simplified Chinese Translation of Document (#158) (c931c5b)
      • -
    • socketd: add backend pseudo-image inventory opcode (47be2d2) +
    • app: Rootfs Repository: contextual empty state and hide banner while searching (009e08e)
      • -
    • socketd: add backend info counters for container inventory (c71485a) +
    • app: Rootfs Repository: filter rootfs assets based on detected device architecture (f81a350)
      • -
    • socketd: implement backend container inventory opcode (93053ad) +
    • app: add custom rootfs repo support (d98185a)
      • -
    • Merge pull request #133 from yoshi3jp/web (cf823ca) +
    • docs: add trailing spaces to markdown quick navigation lists for improved rendering (6629f0a)
      • -
    • Merge branch 'main' into dev (4690c7f) +
    • docs: add disclaimer warning to community-supported devices documentation (6ab10fa)
      • -
    • socketd: satisfy Portainer snapshot probes and expose local events (8d13720) +
    • fix: cancel terminal session notification upon service termination or empty session state (a5baa69)
      • -
    • socketd: add dummy container list endpoint for Portainer probing (8f2baf4) +
    • fix: add hostname sanitization and validation for container configuration menu (7c91bcf)
      • -
    • socketd: expose initial TCP Docker-compatible discovery API (709f5cd) +
    • app: Rootfs Repository: fix rootfs downloads saving with display name instead of filename (9b21332)
      • -
    • Translated using Weblate (Chinese (Simplified Han script)) (#136) (bf38753) +
    • app: removed unused strings (17c979c)
      • -
    • nix: ignore power/suspend key events in logind (#135) (9308fa2) +
    • app: add open-source repository banner to rootfs sheet (3e5f74b)
      • -
    • fixup boot module version and versionCode (2885999) +
    • app: Rootfs Repository: replace download count with build_date from JSON (c3c68a2)
      • -
    • Nix: Fixing rootfs config, update nixpkgs, support for finix (#134) (347754e) +
    • app: Rootfs Repository: adapt to new rootfs.json format (ecbffac)
      • -
    • Web API skeleton (#132) (4131127) +
    • fix: prevent Linux /dev breakage by restricting device pruning to Android environments (21ab8dc)
      • -
    • fix(icons): clear OS info cache on container uninstall (1ccfc66) +
    • fix: nuke container sessions before stop/restart (58b5973)
      • -
    • feat(icons): prefetch distro icon on container start, cache forever, apply to all 3 card locations (141843e) +
    • post_extract_fixes: restrict dhcpcd to NAT mode and whitelist eth interfaces to prevent Android network interference (b6c5cbc)
      • -
    • feat(ui): synchronize container installer options and enhance UI consistency (3e3b027) +
    • post_extract_fixes/docs: gate udev services behind hardware access config and update documentation (2d9c389)
      • -
    • ui: unify distro icon fetching and clear stale cache on stop/restart (f402152) +
    • Translated using Weblate (#153) (1f00fbb)
      • -
    • feat(ui): add custom icons for 22 popular Linux distributions in container details (cfe0c7e) +
    • app: fix cancel button not stopping DownloadManager download (dac54d4)
      • -
    • ui: fix real-time IP updates and prevent stale data display on restart (802524a) +
    • Added docs dispatch workflow to trigger web repo on Documentation changes (#156) (ef2dc4a)
      • -
    • virt: fix frozen/drifting uptime across all kernel versions (c04446c) +
    • Added metatags to Documentation (#155) (7dcbf04)
      • -
    • Merge branch 'main' into dev (b0871d5) +
    • Correct model number for two devices (#154) (a8f6100)
      • -
    • Translated using Weblate (Chinese (Traditional Han script)) (#131) (91089e6) +
    • app: use overflow-driven font auto-shrink for rootfs asset card names (544e358)
      • -
    • app: add support for configuring a custom init binary for containers (5a4cf94) +
    • app: implement rootfs repository browser and download manager for rootfs tarballs (65a042a)
      • -
    • boot: add --init=PATH to override the default init binary (de4e15d) +
    • app: add support for OpenRC init system management in the container info menu (d336534)
      • -
    • virt: decouple resource visibility from cgroup limits (59160a4) +
    • docs: added oppo reno10 devices to GKI support list (#152) (34a68b2)
      • -
    • System-wide init family awareness (#129) (1660f6e) +
    • docs: added Oneplus SM8250 devices to Non-GKI support list (#151) (5358ec6)
      • -
    • Merge branch 'main' into dev (ff42b09) +
    • Translated using Weblate (Khmer (Central), Portuguese) (#150) (ee10cc8)
      • -
    • cgroup: disable virtualization when controllers are unavailable (fe3553c) +
    • requirements: update kernel configuration to include TMPFS_POSIX_ACL and reorganize networking settings (9ab49f7)
      • -
    • feat: add [VIRT] prefix support to message logging filter (c455b09) +
    • Add machine-readable output support to show command (7c4864f)
      • -
    • feat(virt): implement resource visibility virtualization (9802718) +
    • docs: Fix duplicated 'https://' and format chart (#148) (5aeb895)
      • -
    • cgroup: implement resource constraints via v2 delegation (84c4ca7) -
      • -
    • [daemon] add optional backend bridge for future socket API service (#110) (59e53d6) -
      • -
    • Add OnePlus SM8650(LineageOS) to community support devices list (#125) (e770d6f) -
      • -
    • Add Nothing Phone (1) to supported devices list (#126) (f5b557e) +
    • docs: Update 5.10 GKI community supported devices (#147) (6220539)
    @@ -284,10 +278,10 @@

    What's Changed

    Older Versions

    Previous releases

    -
    +
    VersionDate
    Droidspaces v6.1.52026-05-15Download
    + - -
    VersionDate
    Droidspaces v6.2.02026-05-22Download
    Droidspaces v6.1.52026-05-15Download
    Musl Toolchains to compile Droidspaces2026-05-14Download
    Droidspaces v6.1.02026-05-13Download
    Droidspaces v6.0.02026-04-24Download
    +Droidspaces v6.1.02026-05-13Download
    diff --git a/index.html b/index.html index 5f1bcdf..de8fe2e 100644 --- a/index.html +++ b/index.html @@ -62,7 +62,7 @@ "Material 3 management app with built-in terminal" ], "fileSize": "400KB", - "softwareVersion": "6.2.0", + "softwareVersion": "6.2.5", "license": "https://github.com/ravindu644/Droidspaces-OSS/blob/main/LICENSE", "sameAs": [ "https://github.com/ravindu644/Droidspaces-OSS", @@ -141,7 +141,7 @@
    -
    v6.2.0 · Open Source
    +
    v6.2.5 · Open Source

    Linux containers
    on From de31f255cfeb6ba641b5be69bc04344091684bd4 Mon Sep 17 00:00:00 2001 From: docs-bot Date: Thu, 4 Jun 2026 15:29:19 +0000 Subject: [PATCH 21/22] docs: update from source@e7f5ad6 --- docs/community-supported-devices.html | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index 8f8ecbb..0103224 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -449,6 +449,7 @@

    GKI Devices (Kernel 5.4 and up)

    Xiaomi 17 Pro max (Chinese variant)25113PN0ECHyperOS 3.0 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- 红魔 11 Pro (Chinese variant)NX809JRedMagicOS11 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- HONOR Magic Pad 3 Pro 13.3 (Chinese variant)YLP-W00MagicOS10 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- +Xiaomi Pad 7 (Chinese variant)2410CRP4CCHyperOS 2.0 - Android 156.1.118Sukisu UltraSourceDownloadBothTurnip & ZinkWorkingHuangJunLin8Supports NTsync Xiaomi Pad 8 Pro (Chinese variant)25091RP04CHyperOS 3.0 - Android 166.6.77ResukisuSourceDownloadBothTurnip & VirglWorking404-GCrossApplicable to the international version
    Supports NTsync Xiaomi 15 (Chinese variant)24129PN74CHyperOS 3.0 - Android 166.6.77ResukisuSourceDownloadBothTurnip & VirglWorking404-GCrossApplicable to the international version
    Supports NTsync Xiaomi 14 (Chinese variant)23127PN0CCHyperOS 3.0 - Android 166.1.138ResukisuSourceDownloadBothTurnip & VirglWorking爱你么么哒qcjl哟Applicable to the international version From 9968c8ede5b35c8397170551fd9fff3bf144e00d Mon Sep 17 00:00:00 2001 From: docs-bot Date: Fri, 5 Jun 2026 10:17:43 +0000 Subject: [PATCH 22/22] docs: update from source@685fd89 --- docs/community-supported-devices.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/community-supported-devices.html b/docs/community-supported-devices.html index 0103224..825b60b 100644 --- a/docs/community-supported-devices.html +++ b/docs/community-supported-devices.html @@ -450,8 +450,8 @@

    GKI Devices (Kernel 5.4 and up)

    红魔 11 Pro (Chinese variant)NX809JRedMagicOS11 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- HONOR Magic Pad 3 Pro 13.3 (Chinese variant)YLP-W00MagicOS10 - Android 166.12.23noneSourceDownloadBothTurnip & VirglWorking@Goldzxcbug- Xiaomi Pad 7 (Chinese variant)2410CRP4CCHyperOS 2.0 - Android 156.1.118Sukisu UltraSourceDownloadBothTurnip & ZinkWorkingHuangJunLin8Supports NTsync -Xiaomi Pad 8 Pro (Chinese variant)25091RP04CHyperOS 3.0 - Android 166.6.77ResukisuSourceDownloadBothTurnip & VirglWorking404-GCrossApplicable to the international version
    Supports NTsync -Xiaomi 15 (Chinese variant)24129PN74CHyperOS 3.0 - Android 166.6.77ResukisuSourceDownloadBothTurnip & VirglWorking404-GCrossApplicable to the international version
    Supports NTsync +Xiaomi Pad 8 Pro (Chinese variant)25091RP04CHyperOS 3.0 - Android 166.6.77Resukisu & NoRootSourceReSukiSU
    NoRootBothTurnip & VirglWorking404-GCrossApplicable to the international version
    Supports NTsync
    ReSukiSU version 34924 +Xiaomi 15 (Chinese variant)24129PN74CHyperOS 3.0 - Android 166.6.77Resukisu & NoRootSourceReSukiSU
    NoRootBothTurnip & VirglWorking404-GCrossApplicable to the international version
    Supports NTsync
    ReSukiSU version 34924 Xiaomi 14 (Chinese variant)23127PN0CCHyperOS 3.0 - Android 166.1.138ResukisuSourceDownloadBothTurnip & VirglWorking爱你么么哒qcjl哟Applicable to the international version 红魔 9 Pro (Chinese variant)NX769JRedMagicOS11 - Android 166.1.124ResukisuSourceDownloadBothTurnip & VirglWorking@sjszero- 红魔 9 SPro+ (Chinese variant)NX769JRedMagicOS11 - Android 166.1.25ResukisuSourceDownloadBothTurnip & VirglWorking@sjszero-