Skip to content

Instantly share code, notes, and snippets.

@gauravssnl
Forked from AngelaCooljx/Guide-of-Lindroid.md
Created October 4, 2025 07:26
Show Gist options
  • Save gauravssnl/da2e96a6e6710b2e46424b72f32b3424 to your computer and use it in GitHub Desktop.
Save gauravssnl/da2e96a6e6710b2e46424b72f32b3424 to your computer and use it in GitHub Desktop.

Revisions

  1. @AngelaCooljx AngelaCooljx revised this gist Nov 29, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -64,7 +64,7 @@ Official group: https://t.me/linux_on_droid
    ## How to Use Lindroid?
    1. Download and prepare the root filesystem
    - Download the pre-packaged Debian image from [lindroid-rootfs releases](https://github.com/Linux-on-droid/lindroid-rootfs/Releases) or [Lindroid website](https://lindroid.org/lindroid.tar.gz). Ensure that the folders (e.g., etc/, bin/, usr/...) in the archive are at the root level, not within an inner directory like `rootfs/`. If not, repack it.
    - Download the pre-packaged Debian image from [lindroid-rootfs releases](https://github.com/Linux-on-droid/lindroid-rootfs/Releases) or [Lindroid website](https://lindroid.org/new_rootfs_241124.zip.tar.gz). Ensure that the folders (e.g., etc/, bin/, usr/...) in the archive are at the root level, not within an inner directory like `rootfs/`. If not, repack it.
    - Push it to /data/data/org.lindroid.ui/files/rootfs.tar.gz (rename to rootfs).
    - Open Lindroid and follow the prompts to create the container.
  2. @AngelaCooljx AngelaCooljx revised this gist Nov 29, 2024. 1 changed file with 1 addition and 9 deletions.
    10 changes: 1 addition & 9 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -18,17 +18,9 @@ Official group: https://t.me/linux_on_droid
    ```
    git clone https://github.com/Linux-on-droid/external_lxc external/lxc
    ```
    - Clone `libhybris` (use the default `lindroid-21` branch) to `$ANDROID_BUILD_TOP/libhybris`.
    - Clone `libhybris` to `$ANDROID_BUILD_TOP/libhybris`.
    ```
    git clone https://github.com/Linux-on-droid/libhybris libhybris
    ```
    > If Android 14 QPR3, pick https://github.com/Linux-on-droid/libhybris/commit/bfa53d30b4249d9eb183964bbd80244ed4e25f3b.
    > ```
    > cd $ANDROID_BUILD_TOP/libhybris
    > wget https://github.com/Linux-on-droid/libhybris/commit/bfa53d30b4249d9eb183964bbd80244ed4e25f3b.patch
    > git am bfa53d3*.patch
    > cd $ANDROID_BUILD_TOP
    > ```
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`.
    ```
    cd $ANDROID_BUILD_TOP/frameworks/native
  3. @AngelaCooljx AngelaCooljx revised this gist Nov 29, 2024. 1 changed file with 1 addition and 6 deletions.
    7 changes: 1 addition & 6 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -136,13 +136,8 @@ Official group: https://t.me/linux_on_droid
    systemctl restart systemd-logind
    ```
    as root if sddm doesn't work
    - If you have issues with starting kde (but sddm is fine) on new rootfs, for now do
    ```
    sudo apt install xwayland=2:24.1.0-1
    ```
    - Download this [trusted.gpg](https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/trusted.gpg) extracted from the earlier rootfs and put it in `/etc/apt/trusted.gpg.d/` to resolve the warning of `apt update`
    - Download this [public-key.asc](https://t.me/linux_on_droid/5437) and push to `/etc/apt/trusted.gpg.d/lindroid.asc` to resolve the GPG warning of `apt update`
    - Install `kscreen` to restore display settings, `kinfocenter` to restore about system option.
    - A self-packed rootfs: https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/rootfs-self.tar.gz
    ## Notes:
    - Default **username and password** are both `lindroid`.
    - Subsequent usage may encounter touch issues; restart Lindroid, sddm and systemd-logind as needed.
  4. @AngelaCooljx AngelaCooljx revised this gist Nov 27, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -154,6 +154,6 @@ This guide is a compilation of my personal exploration and guidance from Lindroi
    Expect some initial issues, but it’s a promising start. Explore further on your own.
    **If you need more support, please join [the official Lindroid group](https://t.me/linux_on_droid). Read [#guide](https://t.me/linux_on_droid/1263) to get started**
    **If you need more support, please join [the official Lindroid group](https://t.me/linux_on_droid). Read the official [#guide](https://t.me/linux_on_droid/1263) to get started**
    28/6/24
  5. @AngelaCooljx AngelaCooljx revised this gist Nov 27, 2024. 1 changed file with 4 additions and 2 deletions.
    6 changes: 4 additions & 2 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -1,4 +1,6 @@
    # Guide of Lindroid
    # An Unofficial Guide of Lindroid
    **Official Guide: https://t.me/linux_on_droid/1263**

    ## What is Lindroid?
    Lindroid is an Android app that lets you run Linux in a container, with support for hardware-acceleration.
    Official group: https://t.me/linux_on_droid
    @@ -152,6 +154,6 @@ This guide is a compilation of my personal exploration and guidance from Lindroi
    Expect some initial issues, but it’s a promising start. Explore further on your own.
    **If you need more support, please join [the official Lindroid group](https://t.me/linux_on_droid). Read #guide to get started**
    **If you need more support, please join [the official Lindroid group](https://t.me/linux_on_droid). Read [#guide](https://t.me/linux_on_droid/1263) to get started**
    28/6/24
  6. @AngelaCooljx AngelaCooljx revised this gist Nov 27, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -61,7 +61,7 @@ Official group: https://t.me/linux_on_droid
    CONFIG_CGROUP_DEVICE=y
    CONFIG_CGROUP_FREEZER=y
    ```
    - For GKI 5.10, refer to this [source](https://github.com/lateautumn233/Common-Android-Kernel-Tree/tree/lxc) and ensure `CONFIG_VT=y`. For 5.15 and 6.1, explore the configurations accordingly.
    - For GKI 5.10, refer to this [source](https://github.com/lateautumn233/Common-Android-Kernel-Tree/tree/lxc). For 5.15 and 6.1, explore the configurations accordingly.
    - I recommend that compile KernelSU simultaneously for root access (use v0.9.5 tag for non-GKI). Or use magisk etc.
    5. Build your ROM using the userdebug variant:
  7. @AngelaCooljx AngelaCooljx revised this gist Nov 27, 2024. 1 changed file with 9 additions and 10 deletions.
    19 changes: 9 additions & 10 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -50,17 +50,16 @@ Official group: https://t.me/linux_on_droid
    4. Kernel configuration:
    - For non-GKI devices, refer to kernel configurations for enabling LXC/Docker support.
    > Search keywords 'lxc docker android' in GitHub
    - Make sure to add `CONFIG_VT=y`.
    - Example kernel configurations provided by Lindroid developers include:
    ```
    +CONFIG_SYSVIPC=y
    +CONFIG_UTS_NS=y
    +CONFIG_PID_NS=y
    +CONFIG_IPC_NS=y
    +CONFIG_USER_NS=y
    +CONFIG_NET_NS=y
    +CONFIG_CGROUP_DEVICE=y
    +CONFIG_KERNEL_CGROUP_FREEZER=y (likely `CONFIG_CGROUP_FREEZER`)
    CONFIG_SYSVIPC=y
    CONFIG_UTS_NS=y
    CONFIG_PID_NS=y
    CONFIG_IPC_NS=y
    CONFIG_USER_NS=y
    CONFIG_NET_NS=y
    CONFIG_CGROUP_DEVICE=y
    CONFIG_CGROUP_FREEZER=y
    ```
    - For GKI 5.10, refer to this [source](https://github.com/lateautumn233/Common-Android-Kernel-Tree/tree/lxc) and ensure `CONFIG_VT=y`. For 5.15 and 6.1, explore the configurations accordingly.
    - I recommend that compile KernelSU simultaneously for root access (use v0.9.5 tag for non-GKI). Or use magisk etc.
    @@ -153,6 +152,6 @@ This guide is a compilation of my personal exploration and guidance from Lindroi
    Expect some initial issues, but it’s a promising start. Explore further on your own.
    **If you need more support, please join [the official Lindroid group](https://t.me/linux_on_droid)**
    **If you need more support, please join [the official Lindroid group](https://t.me/linux_on_droid). Read #guide to get started**
    28/6/24
  8. @AngelaCooljx AngelaCooljx revised this gist Aug 9, 2024. 1 changed file with 30 additions and 2 deletions.
    32 changes: 30 additions & 2 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -9,10 +9,38 @@ Official group: https://t.me/linux_on_droid

    2. Clone the necessary repositories [Linux-on-droid repository](https://github.com/Linux-on-droid):
    - Clone `vendor_lindroid` from to `$ANDROID_BUILD_TOP/vendor/lindroid`.
    ```
    git clone https://github.com/Linux-on-droid/vendor_lindroid vendor/lindroid
    ```
    - Clone `external_lxc` to `$ANDROID_BUILD_TOP/external/lxc`.
    - Clone `libhybris` (use the default `lindroid-21` branch) to `$ANDROID_BUILD_TOP/libhybris`. If QPR3, pick https://github.com/Linux-on-droid/libhybris/commit/bfa53d30b4249d9eb183964bbd80244ed4e25f3b.
    ```
    git clone https://github.com/Linux-on-droid/external_lxc external/lxc
    ```
    - Clone `libhybris` (use the default `lindroid-21` branch) to `$ANDROID_BUILD_TOP/libhybris`.
    ```
    git clone https://github.com/Linux-on-droid/libhybris libhybris
    ```
    > If Android 14 QPR3, pick https://github.com/Linux-on-droid/libhybris/commit/bfa53d30b4249d9eb183964bbd80244ed4e25f3b.
    > ```
    > cd $ANDROID_BUILD_TOP/libhybris
    > wget https://github.com/Linux-on-droid/libhybris/commit/bfa53d30b4249d9eb183964bbd80244ed4e25f3b.patch
    > git am bfa53d3*.patch
    > cd $ANDROID_BUILD_TOP
    > ```
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`.
    > Use https://review.lineageos.org/c/LineageOS/android_frameworks_native/+/351543 for Android 13.
    ```
    cd $ANDROID_BUILD_TOP/frameworks/native
    wget https://github.com/LMODroid/platform_frameworks_native/commit/51b680f33b66e06b18725fdf9a54fa923c14a10b.patch
    git am 51b680f*.patch
    cd $ANDROID_BUILD_TOP
    ```
    > If Android 13, use https://review.lineageos.org/c/LineageOS/android_frameworks_native/+/351543
    > ```
    > cd $ANDROID_BUILD_TOP/frameworks/native
    > wget https://github.com/LineageOS/android_frameworks_native/commit/94dd1b1bda79e783b1610470a5284bb6f300340e.patch
    > git am 94dd1b1*.patch
    > cd $ANDROID_BUILD_TOP
    > ```
    3. Modify device configurations:
    - Add `$(call inherit-product, vendor/lindroid/lindroid.mk)` to your device's mk file.
  9. @AngelaCooljx AngelaCooljx revised this gist Aug 5, 2024. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -112,6 +112,7 @@ Official group: https://t.me/linux_on_droid
    sudo apt install xwayland=2:24.1.0-1
    ```
    - Download this [trusted.gpg](https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/trusted.gpg) extracted from the earlier rootfs and put it in `/etc/apt/trusted.gpg.d/` to resolve the warning of `apt update`
    - Install `kscreen` to restore display settings, `kinfocenter` to restore about system option.
    - A self-packed rootfs: https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/rootfs-self.tar.gz
    ## Notes:
    - Default **username and password** are both `lindroid`.
  10. @AngelaCooljx AngelaCooljx revised this gist Aug 3, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -10,7 +10,7 @@ Official group: https://t.me/linux_on_droid
    2. Clone the necessary repositories [Linux-on-droid repository](https://github.com/Linux-on-droid):
    - Clone `vendor_lindroid` from to `$ANDROID_BUILD_TOP/vendor/lindroid`.
    - Clone `external_lxc` to `$ANDROID_BUILD_TOP/external/lxc`.
    - Clone `libhybris` (use the staging/lindroid-21 branch) to `$ANDROID_BUILD_TOP/libhybris`.
    - Clone `libhybris` (use the default `lindroid-21` branch) to `$ANDROID_BUILD_TOP/libhybris`. If QPR3, pick https://github.com/Linux-on-droid/libhybris/commit/bfa53d30b4249d9eb183964bbd80244ed4e25f3b.
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`.
    > Use https://review.lineageos.org/c/LineageOS/android_frameworks_native/+/351543 for Android 13.
  11. @AngelaCooljx AngelaCooljx revised this gist Jul 9, 2024. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -114,6 +114,7 @@ Official group: https://t.me/linux_on_droid
    - Download this [trusted.gpg](https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/trusted.gpg) extracted from the earlier rootfs and put it in `/etc/apt/trusted.gpg.d/` to resolve the warning of `apt update`
    - A self-packed rootfs: https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/rootfs-self.tar.gz
    ## Notes:
    - Default **username and password** are both `lindroid`.
    - Subsequent usage may encounter touch issues; restart Lindroid, sddm and systemd-logind as needed.
    - External keyboard/mouse is recommended. KDE Connect can help with remote control.
    - There are also apps that can turn your other phone into a keyboard via Bluetooth.
  12. @AngelaCooljx AngelaCooljx revised this gist Jul 9, 2024. 1 changed file with 3 additions and 2 deletions.
    5 changes: 3 additions & 2 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -11,7 +11,8 @@ Official group: https://t.me/linux_on_droid
    - Clone `vendor_lindroid` from to `$ANDROID_BUILD_TOP/vendor/lindroid`.
    - Clone `external_lxc` to `$ANDROID_BUILD_TOP/external/lxc`.
    - Clone `libhybris` (use the staging/lindroid-21 branch) to `$ANDROID_BUILD_TOP/libhybris`.
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`. Use https://review.lineageos.org/c/LineageOS/android_frameworks_native/+/351543 for Android 13.
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`.
    > Use https://review.lineageos.org/c/LineageOS/android_frameworks_native/+/351543 for Android 13.
    3. Modify device configurations:
    - Add `$(call inherit-product, vendor/lindroid/lindroid.mk)` to your device's mk file.
    @@ -38,7 +39,7 @@ Official group: https://t.me/linux_on_droid
    5. Build your ROM using the userdebug variant:
    - Avoid using user variant for now.
    - If FCM (Framework Compatibility Matrix) errors occur, leading to OTA package build failure, manually modify configs in `$ANDROID_BUILD_TOP/kernel/configs/` or just build images (`make systemimage vendorimage productimage bootimage` ...) and flash them using fastboot in fastbootd.
    - If FCM (Framework Compatibility Matrix) errors occur, leading to OTA package build failure, manually modify configurations in the `$ANDROID_BUILD_TOP/kernel/configs/[ANDROID VERSION]/[KERNEL VERSION]/` directory of the ROM source.
    ## How to Use Lindroid?
    1. Download and prepare the root filesystem
  13. @AngelaCooljx AngelaCooljx revised this gist Jul 9, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -11,7 +11,7 @@ Official group: https://t.me/linux_on_droid
    - Clone `vendor_lindroid` from to `$ANDROID_BUILD_TOP/vendor/lindroid`.
    - Clone `external_lxc` to `$ANDROID_BUILD_TOP/external/lxc`.
    - Clone `libhybris` (use the staging/lindroid-21 branch) to `$ANDROID_BUILD_TOP/libhybris`.
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`. Use https://review.lineageos.org/c/LineageOS/android_frameworks_native/+/351543 for Android 13.

    3. Modify device configurations:
    - Add `$(call inherit-product, vendor/lindroid/lindroid.mk)` to your device's mk file.
  14. @AngelaCooljx AngelaCooljx revised this gist Jul 8, 2024. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -115,6 +115,7 @@ Official group: https://t.me/linux_on_droid
    ## Notes:
    - Subsequent usage may encounter touch issues; restart Lindroid, sddm and systemd-logind as needed.
    - External keyboard/mouse is recommended. KDE Connect can help with remote control.
    - There are also apps that can turn your other phone into a keyboard via Bluetooth.
    - Strongly suggest SSH for better terminal experience.
    This guide is a compilation of my personal exploration and guidance from Lindroid developers [Erfan Abdi, Luka, Nick].
  15. @AngelaCooljx AngelaCooljx revised this gist Jul 8, 2024. 1 changed file with 5 additions and 5 deletions.
    10 changes: 5 additions & 5 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -85,7 +85,7 @@ Official group: https://t.me/linux_on_droid
    am force-stop org.lindroid.ui
    ```
    ## Some supplements:
    - The most important thing is patience and waiting. SDDM usually starts one or two minutes after starting Lindroid. Please do not do anything during this period of black screen.
    - The most important thing is **patience and waiting**. SDDM usually starts one or two minutes after starting Lindroid. Please do not do anything during this period of black screen.
    - XDG hack to run kwin manually:
    ```
    export XDG_RUNTIME_DIR=/tmp/runtime-lindroid
    @@ -98,7 +98,7 @@ Official group: https://t.me/linux_on_droid
    usermod -aG android_input lindroid
    usermod -aG android_input sddm
    ```
    Modify /etc/logind.conf to fix power button
    Modify `/etc/logind.conf` to fix power button
    Restart systemd-logind on every login to run sddm
    - Try:
    ```
    @@ -110,17 +110,17 @@ Official group: https://t.me/linux_on_droid
    ```
    sudo apt install xwayland=2:24.1.0-1
    ```
    - Download this [trusted.gpg](https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/trusted.gpg) extracted from the earlier rootfs and put it in `/etc/apt/trusted.gpg.d/` to resolve the warning of `apt update`
    - A self-packed rootfs: https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/rootfs-self.tar.gz
    ## Notes:
    - Subsequent usage may encounter touch issues; restart Lindroid and SDDM as needed.
    - Use `plasma-settings` instead of `system-settings` if systemsettings crashes.
    - Subsequent usage may encounter touch issues; restart Lindroid, sddm and systemd-logind as needed.
    - External keyboard/mouse is recommended. KDE Connect can help with remote control.
    - Strongly suggest SSH for better terminal experience.
    This guide is a compilation of my personal exploration and guidance from Lindroid developers [Erfan Abdi, Luka, Nick].
    Expect some initial issues, but it’s a promising start. Explore further on your own.
    **If you need further support, please join [the official Lindroid group](https://t.me/linux_on_droid)**
    **If you need more support, please join [the official Lindroid group](https://t.me/linux_on_droid)**
    28/6/24
  16. @AngelaCooljx AngelaCooljx revised this gist Jul 7, 2024. 1 changed file with 3 additions and 1 deletion.
    4 changes: 3 additions & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -108,7 +108,7 @@ Official group: https://t.me/linux_on_droid
    as root if sddm doesn't work
    - If you have issues with starting kde (but sddm is fine) on new rootfs, for now do
    ```
    sudo apt install xwayland=2:24.1.0-1`
    sudo apt install xwayland=2:24.1.0-1
    ```
    - A self-packed rootfs: https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/rootfs-self.tar.gz
    ## Notes:
    @@ -121,4 +121,6 @@ This guide is a compilation of my personal exploration and guidance from Lindroi
    Expect some initial issues, but it’s a promising start. Explore further on your own.
    **If you need further support, please join [the official Lindroid group](https://t.me/linux_on_droid)**
    28/6/24
  17. @AngelaCooljx AngelaCooljx revised this gist Jul 7, 2024. 1 changed file with 27 additions and 0 deletions.
    27 changes: 27 additions & 0 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -84,6 +84,33 @@ Official group: https://t.me/linux_on_droid
    su -c chmod 777 /dev/uinput
    am force-stop org.lindroid.ui
    ```
    ## Some supplements:
    - The most important thing is patience and waiting. SDDM usually starts one or two minutes after starting Lindroid. Please do not do anything during this period of black screen.
    - XDG hack to run kwin manually:
    ```
    export XDG_RUNTIME_DIR=/tmp/runtime-lindroid
    mkdir -p $XDG_RUNTIME_DIR
    chmod 700 $XDG_RUNTIME_DIR
    ```
    - Execute this command to get input:
    ```
    groupadd --gid 1004 android_input
    usermod -aG android_input lindroid
    usermod -aG android_input sddm
    ```
    Modify /etc/logind.conf to fix power button
    Restart systemd-logind on every login to run sddm
    - Try:
    ```
    loginctl kill-user lindroid
    systemctl restart systemd-logind
    ```
    as root if sddm doesn't work
    - If you have issues with starting kde (but sddm is fine) on new rootfs, for now do
    ```
    sudo apt install xwayland=2:24.1.0-1`
    ```
    - A self-packed rootfs: https://github.com/xiaomi-mt6885-devs/releases/releases/download/20240628/rootfs-self.tar.gz
    ## Notes:
    - Subsequent usage may encounter touch issues; restart Lindroid and SDDM as needed.
    - Use `plasma-settings` instead of `system-settings` if systemsettings crashes.
  18. @AngelaCooljx AngelaCooljx revised this gist Jul 1, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -38,7 +38,7 @@ Official group: https://t.me/linux_on_droid
    5. Build your ROM using the userdebug variant:
    - Avoid using user variant for now.
    - If FCM (Framework Compatibility Matrix) errors occur, leading to OTA package build failure, manually build images (`make systemimage vendorimage productimage bootimage` ...) and flash them using fastboot in fastbootd.
    - If FCM (Framework Compatibility Matrix) errors occur, leading to OTA package build failure, manually modify configs in `$ANDROID_BUILD_TOP/kernel/configs/` or just build images (`make systemimage vendorimage productimage bootimage` ...) and flash them using fastboot in fastbootd.
    ## How to Use Lindroid?
    1. Download and prepare the root filesystem
  19. @AngelaCooljx AngelaCooljx revised this gist Jul 1, 2024. 1 changed file with 1 addition and 0 deletions.
    1 change: 1 addition & 0 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -11,6 +11,7 @@ Official group: https://t.me/linux_on_droid
    - Clone `vendor_lindroid` from to `$ANDROID_BUILD_TOP/vendor/lindroid`.
    - Clone `external_lxc` to `$ANDROID_BUILD_TOP/external/lxc`.
    - Clone `libhybris` (use the staging/lindroid-21 branch) to `$ANDROID_BUILD_TOP/libhybris`.
    - Pick the patch from https://gerrit.libremobileos.com/c/LMODroid/platform_frameworks_native/+/12936 to `$ANDROID_BUILD_TOP/frameworks/native`

    3. Modify device configurations:
    - Add `$(call inherit-product, vendor/lindroid/lindroid.mk)` to your device's mk file.
  20. @AngelaCooljx AngelaCooljx revised this gist Jun 30, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -10,7 +10,7 @@ Official group: https://t.me/linux_on_droid
    2. Clone the necessary repositories [Linux-on-droid repository](https://github.com/Linux-on-droid):
    - Clone `vendor_lindroid` from to `$ANDROID_BUILD_TOP/vendor/lindroid`.
    - Clone `external_lxc` to `$ANDROID_BUILD_TOP/external/lxc`.
    - Clone `libhybris` (use the staging/lindroid-20 branch) to `$ANDROID_BUILD_TOP/libhybris`.
    - Clone `libhybris` (use the staging/lindroid-21 branch) to `$ANDROID_BUILD_TOP/libhybris`.

    3. Modify device configurations:
    - Add `$(call inherit-product, vendor/lindroid/lindroid.mk)` to your device's mk file.
  21. @AngelaCooljx AngelaCooljx revised this gist Jun 29, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -41,7 +41,7 @@ Official group: https://t.me/linux_on_droid
    ## How to Use Lindroid?
    1. Download and prepare the root filesystem
    - Download the pre-packaged Debian image from [lindroid-rootfs releases](https://github.com/Linux-on-droid/lindroid-rootfs/Releases).
    - Download the pre-packaged Debian image from [lindroid-rootfs releases](https://github.com/Linux-on-droid/lindroid-rootfs/Releases) or [Lindroid website](https://lindroid.org/lindroid.tar.gz). Ensure that the folders (e.g., etc/, bin/, usr/...) in the archive are at the root level, not within an inner directory like `rootfs/`. If not, repack it.
    - Push it to /data/data/org.lindroid.ui/files/rootfs.tar.gz (rename to rootfs).
    - Open Lindroid and follow the prompts to create the container.
  22. @AngelaCooljx AngelaCooljx revised this gist Jun 29, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -56,7 +56,7 @@ Official group: https://t.me/linux_on_droid
    ```
    - Optionally, change Debian source mirrors for CN users:
    ```shell
    sed -i 's/deb.debian.org/mirrors.bfsu.edu.cn/g' /etc/apt/sources.list`
    sed -i 's/deb.debian.org/mirrors.bfsu.edu.cn/g' /etc/apt/sources.list
    ```
    - Then upgrade all packages (Especially Kwin etc. from lindroid)
    ```shell
  23. @AngelaCooljx AngelaCooljx revised this gist Jun 29, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -85,7 +85,7 @@ Official group: https://t.me/linux_on_droid
    ```
    ## Notes:
    - Subsequent usage may encounter touch issues; restart Lindroid and SDDM as needed.
    - Use `plasma-settings` instead of `system-settings` for now.
    - Use `plasma-settings` instead of `system-settings` if systemsettings crashes.
    - External keyboard/mouse is recommended. KDE Connect can help with remote control.
    - Strongly suggest SSH for better terminal experience.
  24. @AngelaCooljx AngelaCooljx revised this gist Jun 29, 2024. 1 changed file with 6 additions and 4 deletions.
    10 changes: 6 additions & 4 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -11,7 +11,6 @@ Official group: https://t.me/linux_on_droid
    - Clone `vendor_lindroid` from to `$ANDROID_BUILD_TOP/vendor/lindroid`.
    - Clone `external_lxc` to `$ANDROID_BUILD_TOP/external/lxc`.
    - Clone `libhybris` (use the staging/lindroid-20 branch) to `$ANDROID_BUILD_TOP/libhybris`.
    - Cherry-pick or am/apply the patch from [this commit](https://github.com/Linux-on-droid/platform_system_core/commit/cb644190eeb9fefc3959a01dbdb83d89873e0b73) to `$ANDROID_BUILD_TOP/system/core`.

    3. Modify device configurations:
    - Add `$(call inherit-product, vendor/lindroid/lindroid.mk)` to your device's mk file.
    @@ -42,7 +41,7 @@ Official group: https://t.me/linux_on_droid
    ## How to Use Lindroid?
    1. Download and prepare the root filesystem
    - Download the pre-packaged Debian image from [Lindroid website](https://lindroid.org/lindroid.tar.gz).
    - Download the pre-packaged Debian image from [lindroid-rootfs releases](https://github.com/Linux-on-droid/lindroid-rootfs/Releases).
    - Push it to /data/data/org.lindroid.ui/files/rootfs.tar.gz (rename to rootfs).
    - Open Lindroid and follow the prompts to create the container.
    @@ -55,12 +54,15 @@ Official group: https://t.me/linux_on_droid
    lxc_attach default
    /bin/bash -c "source /etc/profile && exec su - root"
    ```
    - Optionally, change Debian source mirrors for CN users: `sed -i 's/deb.debian.org/mirrors.bfsu.edu.cn/g' /etc/apt/sources.list`
    - Optionally, change Debian source mirrors for CN users:
    ```shell
    sed -i 's/deb.debian.org/mirrors.bfsu.edu.cn/g' /etc/apt/sources.list`
    ```
    - Then upgrade all packages (Especially Kwin etc. from lindroid)
    ```shell
    apt update && apt-get -o Dpkg::Options::="--force-overwrite" full-upgrade
    ```
    - If there is network error, try
    - If there is a network error, try setting DNS server:
    ```shell
    echo "nameserver 8.8.8.8" > /etc/resolv.conf
    ```
  25. @AngelaCooljx AngelaCooljx revised this gist Jun 29, 2024. 1 changed file with 5 additions and 1 deletion.
    6 changes: 5 additions & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -60,6 +60,10 @@ Official group: https://t.me/linux_on_droid
    ```shell
    apt update && apt-get -o Dpkg::Options::="--force-overwrite" full-upgrade
    ```
    - If there is network error, try
    ```shell
    echo "nameserver 8.8.8.8" > /etc/resolv.conf
    ```
    3. Test and configure the graphical interface:
    - Test graphics with `test_hwcomposer`.
    - Start or restart SDDM service:
    @@ -74,7 +78,7 @@ Official group: https://t.me/linux_on_droid
    ```
    - Use evtest to check for Lindroid virtual input devices. Adjust /dev/uinput permissions if needed and restart Lindroid in adb shell.
    ```shell
    chmod 777 /dev/uinput
    su -c chmod 777 /dev/uinput
    am force-stop org.lindroid.ui
    ```
    ## Notes:
  26. @AngelaCooljx AngelaCooljx revised this gist Jun 28, 2024. 1 changed file with 3 additions and 1 deletion.
    4 changes: 3 additions & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -85,4 +85,6 @@ Official group: https://t.me/linux_on_droid
    This guide is a compilation of my personal exploration and guidance from Lindroid developers [Erfan Abdi, Luka, Nick].
    Expect some initial issues, but it’s a promising start. Explore further on your own.
    Expect some initial issues, but it’s a promising start. Explore further on your own.
    28/6/24
  27. @AngelaCooljx AngelaCooljx revised this gist Jun 28, 2024. No changes.
  28. @AngelaCooljx AngelaCooljx revised this gist Jun 28, 2024. 1 changed file with 4 additions and 3 deletions.
    7 changes: 4 additions & 3 deletions Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -19,8 +19,9 @@ Official group: https://t.me/linux_on_droid
    - Ensure SELinux is set to permissive mode for Lindroid.

    4. Kernel configuration:
    - For non-GKI devices, refer to kernel configurations for enabling LXC/Docker support.(Search keywords 'lxc docker android' in GitHub)
    Make sure to add `CONFIG_VT=y`.
    - For non-GKI devices, refer to kernel configurations for enabling LXC/Docker support.
    > Search keywords 'lxc docker android' in GitHub
    - Make sure to add `CONFIG_VT=y`.
    - Example kernel configurations provided by Lindroid developers include:
    ```
    +CONFIG_SYSVIPC=y
    @@ -37,7 +38,7 @@ Make sure to add `CONFIG_VT=y`.
    5. Build your ROM using the userdebug variant:
    - Avoid using user variant for now.
    - If FCM (Framework Compatibility Matrix) errors occur, leading to OTA package build failure, manually build images (make systemimage vendorimage productimage bootimage ...) and flash them using fastboot in fastbootd.
    - If FCM (Framework Compatibility Matrix) errors occur, leading to OTA package build failure, manually build images (`make systemimage vendorimage productimage bootimage` ...) and flash them using fastboot in fastbootd.
    ## How to Use Lindroid?
    1. Download and prepare the root filesystem
  29. @AngelaCooljx AngelaCooljx revised this gist Jun 28, 2024. No changes.
  30. @AngelaCooljx AngelaCooljx revised this gist Jun 28, 2024. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion Guide-of-Lindroid.md
    Original file line number Diff line number Diff line change
    @@ -1,7 +1,7 @@
    # Guide of Lindroid
    ## What is Lindroid?
    Lindroid is an Android app that lets you run Linux in a container, with support for hardware-acceleration.
    Official group: t.me/linux_on_droid
    Official group: https://t.me/linux_on_droid

    ## How to Compile Lindroid?
    1. Ensure your device has the necessary configurations: