{"id":34692447,"url":"https://github.com/sabamdarif/chroot-distro","last_synced_at":"2026-02-21T20:11:07.881Z","repository":{"id":308571217,"uuid":"1033292856","full_name":"sabamdarif/chroot-distro","owner":"sabamdarif","description":"Install Gnu/Linux distributions on Android ","archived":false,"fork":false,"pushed_at":"2025-12-11T17:57:13.000Z","size":161,"stargazers_count":22,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-12T22:41:02.236Z","etag":null,"topics":["android","chroot","chroot-distro","magisk-module","termux"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sabamdarif.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-06T15:32:57.000Z","updated_at":"2025-12-12T18:42:27.000Z","dependencies_parsed_at":"2025-08-06T17:56:49.468Z","dependency_job_id":"a177949d-e650-45c4-a81b-c2f2b703b171","html_url":"https://github.com/sabamdarif/chroot-distro","commit_stats":null,"previous_names":["sabamdarif/chroot-distro"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/sabamdarif/chroot-distro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabamdarif%2Fchroot-distro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabamdarif%2Fchroot-distro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabamdarif%2Fchroot-distro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabamdarif%2Fchroot-distro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sabamdarif","download_url":"https://codeload.github.com/sabamdarif/chroot-distro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabamdarif%2Fchroot-distro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28010308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-24T02:00:07.193Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","chroot","chroot-distro","magisk-module","termux"],"created_at":"2025-12-24T22:00:35.874Z","updated_at":"2026-02-21T20:11:07.874Z","avatar_url":"https://github.com/sabamdarif.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Chroot Distro\n\n#### Install Linux distributions on Android devices using chroot\n\n![Release](https://img.shields.io/github/v/release/sabamdarif/chroot-distro?style=for-the-badge\u0026color=blueviolet) ![GitHub License](https://img.shields.io/github/license/sabamdarif/chroot-distro?style=for-the-badge) ![Total Downloads](https://img.shields.io/github/downloads/sabamdarif/chroot-distro/total?style=for-the-badge\u0026color=blueviolet)\n\n\u003c/div\u003e\n\n## Prerequisites\n\n- **Back up important files before use**\n- **Rooted Android Device**\n- **BusyBox**: [osm0sis/android-busybox-ndk](https://github.com/osm0sis/android-busybox-ndk) (**Recommended:** v1.36.1)\n\n\u003e [!TIP]\n\u003e KernelSU users do not need to flash busybox as it has built-in busybox support.\n\n---\n\n## Supported Distributions\n\n|                                                                                                                         |                                                                                                                      |                                                                                                          |\n| :---------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------: |\n| ![Alpine Linux](https://img.shields.io/badge/Alpine_Linux-0D597F?style=for-the-badge\u0026logo=alpine-linux\u0026logoColor=white) |  ![Arch Linux](https://img.shields.io/badge/Arch_Linux-1793D1?style=for-the-badge\u0026logo=arch-linux\u0026logoColor=white)   |  ![Debian](https://img.shields.io/badge/Debian-A81D33?style=for-the-badge\u0026logo=debian\u0026logoColor=white)   |\n|          ![Fedora](https://img.shields.io/badge/Fedora-51A2DA?style=for-the-badge\u0026logo=fedora\u0026logoColor=white)          |  ![Kali Linux](https://img.shields.io/badge/Kali_Linux-557C94?style=for-the-badge\u0026logo=kali-linux\u0026logoColor=white)   | ![Manjaro](https://img.shields.io/badge/Manjaro-35BF5C?style=for-the-badge\u0026logo=manjaro\u0026logoColor=white) |\n|       ![OpenSUSE](https://img.shields.io/badge/OpenSUSE-73BA25?style=for-the-badge\u0026logo=opensuse\u0026logoColor=white)       | ![Rocky Linux](https://img.shields.io/badge/Rocky_Linux-10B981?style=for-the-badge\u0026logo=rocky-linux\u0026logoColor=white) |  ![Trisquel](https://img.shields.io/badge/Trisquel-0D597F?style=for-the-badge\u0026logo=gnu\u0026logoColor=white)  |\n|          ![Ubuntu](https://img.shields.io/badge/Ubuntu-E95420?style=for-the-badge\u0026logo=ubuntu\u0026logoColor=white)          |  ![Void Linux](https://img.shields.io/badge/Void_Linux-478061?style=for-the-badge\u0026logo=void-linux\u0026logoColor=white)   |                                                                                                          |\n\n---\n\n## Quick Start\n\n```bash\n\n# List available distributions\nchroot-distro list\n\n# Install a distribution\nchroot-distro install debian\n\n# Login to the distribution\nchroot-distro login debian\n```\n\n---\n\n## Command Reference\n\n| Command        | Aliases                     | Description                    |\n| -------------- | --------------------------- | ------------------------------ |\n| `help`         | `--help`, `-h`, `he`, `hel` | Display help information       |\n| `version`      | `--version`, `-v`           | Show version information       |\n| `list`         | `li`, `ls`                  | List available distributions   |\n| `list-running` |                             | List currently running distros |\n| `install`      | `i`, `in`, `ins`, `add`     | Install a distribution         |\n| `login`        | `sh`                        | Enter distribution shell       |\n| `remove`       | `rm`                        | Remove a distribution          |\n| `unmount`      | `umount`, `um`              | Unmount distribution           |\n| `clear-cache`  | `clear`, `cl`               | Clear downloaded files         |\n\n---\n\n## Commands\n\n### `help`\n\nDisplay general help or command-specific help information:\n\n```bash\nchroot-distro help\nchroot-distro \u003ccommand\u003e --help\n```\n\n### `list`\n\nList all available distributions with their aliases, installation status, and additional information:\n\n```bash\nchroot-distro list\n```\n\n### `list-running`\n\nList currently mounted checking for active mount points:\n\n```bash\nchroot-distro list-running\n```\n\n### `install \u003cdistro\u003e`\n\nInstall a supported distribution:\n\n```bash\nchroot-distro install debian\n```\n\n### `login \u003cdistro\u003e`\n\nEnter a shell session inside the installed distribution:\n\n```bash\nchroot-distro login debian\n```\n\n#### Available Options\n\n- `--user \u003cusername\u003e` – Login as a specified user (user must exist in chroot environment)\n- `--isolated` - Run the specified distro in an isolated chroot environment\n- `--shared-tmp` - Share Termux tmp directory (no compatible with `--isolated`)\n- `--termux-home` – Mount Termux home directory inside chroot (no compatible with `--isolated`)\n- `--bind \u003chost_path\u003e:\u003cchroot_path\u003e` – Bind mount a path from host to chroot (no compatible with `--isolated`)\n- `--work-dir \u003cpath\u003e` – Set custom working directory (default: user's home directory)\n\n#### Execute Commands\n\nRun commands directly inside the chroot environment:\n\n```bash\nchroot-distro login debian -- /bin/sh -c 'apt update'\n```\n\nUse `--` to separate chroot-distro options from the target command.\n\n### `unmount \u003cdistro\u003e`\n\nUnmount all mount points associated with a distribution:\n\n```bash\nchroot-distro unmount debian\n```\n\n#### Options\n\n- `--help` – Display help for this command\n\n#### Examples\n\n```bash\nchroot-distro unmount debian\n```\n\n### `remove \u003cdistro\u003e`\n\nPermanently remove an installed distribution.\n\n\u003e [!WARNING]\n\u003e This operation is irreversible and does not prompt for confirmation.\n\n```bash\nchroot-distro remove fedora\n```\n\n### `clear-cache`\n\nRemove all downloaded rootfs archives to free up storage space:\n\n```bash\nchroot-distro clear-cache\n```\n\n---\n\n## Service Management\n\nChroot Distro includes a lightweight service manager called `serviced` it can start a systemd process without systemd\n\n### Configuration\n\nThe service manager behavior can be configured via the `settings.conf` file located at:\n\n```\n/data/local/chroot-distro/data/settings.conf\n```\n\n\u003e [!TIP]\n\u003e This file can be easily configured using the WebUI.\n\n### Options\n\n| Option                  | Description                                                                 |\n| ----------------------- | --------------------------------------------------------------------------- |\n| `SERVICED`              | Set to `true` to enable the service manager.                                |\n| `SERVICED_VERBOSE_MODE` | Set to `true` to enable verbose logging for debugging service start issues. |\n\n### Usage\n\nWhen `SERVICED` is enabled, `chroot-distro` will automatically start the built-in `serviced` manager when you login. You can then use it to manage services:\n\n```bash\n# Start a service\nserviced start docker\n\n# Start all enabled services\nserviced start\n\n# Enable a service to start on boot\nserviced enable docker\n\n# Disable a service\nserviced disable docker\n\n# Check status\nserviced status docker\n\n# List all services\nserviced list\n```\n\n---\n\n## Termux Integration\n\nTo simplify usage from Termux, create a wrapper script:\n\n1. Open Termux and run:\n\n```bash\nnano $PREFIX/bin/chroot-distro\n```\n\n2. Paste the following content:\n\n```bash\n#!/data/data/com.termux/files/usr/bin/bash\n\nargs=\"\"\nfor arg in \"$@\"; do\n    escaped_arg=$(printf '%s' \"$arg\" | sed \"s/'/'\\\\\\\\''/g\")\n    args=\"$args '$escaped_arg'\"\ndone\n\nsu -c \"/system/bin/chroot-distro $args\"\n```\n\n3. Make the script executable:\n\n```bash\nchmod +x $PREFIX/bin/chroot-distro\n```\n\n- You can now use chroot-distro directly from Termux without switching to root user manually.\n\n---\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n|             **Docker Support**             |             **Flatpak Support**              |\n| :----------------------------------------: | :------------------------------------------: |\n| ![Docker Running](screeenshots/docker.png) | ![Flatpak Running](screeenshots/flatpak.png) |\n\n\u003c/div\u003e\n\n---\n\n## 🔍 Kernel Compatibility Check\n\nBefore attempting to run Docker/Flatpak, it is highly recommended to check if your kernel supports the necessary configurations.\n\n### How to Check\n\n1.  **Install Termux** (if not already installed).\n2.  **Run the Compatibility Check Script**:\n\n    The following script checks for kernel configurations required by Docker\n\n\u003e [!NOTE]\n\u003e This test was verified on **Realme RMX3085** with **Kernel 4.19.325 (Android 15 Custom ROM)**.\n\n```bash\npkg install wget sudo\n\nwget https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh\n\nchmod +x check-config.sh\n\nsed -i '1s_.*_#!/data/data/com.termux/files/usr/bin/bash_' check-config.sh\n\nsudo ./check-config.sh\n```\n\n### Expected Output\n\nYou should see output similar to this:\n\n\u003cdiv align=\"center\"\u003e\n\n![Compatibility Check](screeenshots/compatibility-check.png)\n\n\u003c/div\u003e\n\n\u003e [!TIP]\n\u003e For more details, check out this guide: [ivonblog](https://ivonblog.com/en-us/posts/sony-xperia-5-ii-docker-kernel/)\n\n---\n\n## Support the Project\n\nIf you find this project helpful and would like to support its development, consider buying me a coffee! Your support helps maintain and improve this project.\n\n**Cryptocurrency Donations:**\n\n- **USDT (BEP20,ERC20):** `0x1d216cf986d95491a479ffe5415dff18dded7e71`\n- **USDT (TRC20):** `TCjRKPLG4BgNdHibt2yeAwgaBZVB4JoPaD`\n- **BTC:** `13Q7xf3qZ9xH81rS2gev8N4vD92L9wYiKH`\n- **DOGE:** `DJkMCnBAFG14TV3BqZKmbbjD8Pi1zKLLG6`\n- **ETH:** `0x1d216cf986d95491a479ffe5415dff18dded7e71`\n\n_Every contribution, no matter how small, helps keep this project alive and growing! ❤️_\n\n---\n\n## License\n\nThis project is licensed under the **[GNU General Public License v3.0](LICENSE)**\n\n```\nCopyright (C) 2025 sabamdarif\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n```\n\n---\n\n## Acknowledgments:\n\nSpecial thanks to:\n\n- [proot-distro](https://github.com/termux/proot-distro)\n- [Magisk-Modules-Alt-Repo/chroot-distro](https://github.com/Magisk-Modules-Alt-Repo/chroot-distro)\n- [ravindu644/Ubuntu-Chroot](https://github.com/ravindu644/Ubuntu-Chroot)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ If you enjoy this project, consider giving it a star!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsabamdarif%2Fchroot-distro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsabamdarif%2Fchroot-distro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsabamdarif%2Fchroot-distro/lists"}