Static proot builds for ULS. ULS runs a Linux rootfs on an Android phone over ADB, with proot as the sandbox.
The source is ItsPhysip/proot, branch
uls: termux/proot plus a few fixes that
are waiting upstream. Its
ULS-CHANGES.md
lists each change with its date and upstream PR. Every binary is built by CI
in this repository from a pinned commit of that branch. Release assets carry
SHA-256 sums, and ULS's catalog pins those sums.
Until now ULS used stock proot-me v5.3.0. On Android kernels ≥ 5.8 several path-taking syscalls reach the kernel with the guest path untranslated, and one crashes proot outright. Measured on a Samsung Galaxy S26 Ultra (SM-S948B) (kernel 6.12, Android 16), with no ULS compatibility shims loaded:
| Problem | proot-me 5.3.0 | proot-me 5.4.1 | termux/proot |
|---|---|---|---|
faccessat2: pacman, bash [ -r ], glibc realpath("dir/") |
broken | broken on arm64 (support is x86_64-only) | fixed |
openat2: resolves against the host (/system opens) |
leaks | leaks | fixed |
readlinkat(fd, ""): assertion kills the sandbox (systemd-tmpfiles) |
crashes | fixed | fixed |
fchmodat2: untranslated, so host-only paths are acted on (/system → EROFS) |
broken | broken | broken; fixed in the uls branch (termux/proot#400) |
link2symlink (-l): file destroyed once a name's intermediate suffixes run out (dpkg backups) |
— | — | destroyed; fixed in the uls branch (termux/proot#394) |
The Android SELinux issues that aren't proot's (socket files, hard links,
audit netlink) are handled by ULS's libc shims. termux/proot already reports
the peer's emulated uid for SO_PEERCRED, which the shims alone can't.
INSTALL_DEPS=1 ./build.sh # Debian/Ubuntu; output in dist/The script builds static talloc from the Samba tarball (sha256-checked),
fetches termux/proot at the pinned commit, applies patches/, and links a
static binary with clang. It then runs a proot -r / /bin/true self-test
and writes dist/BUILDINFO-<arch>.
| Arch | Built on | Tested on a device |
|---|---|---|
| aarch64 | native arm64 runner | yes (Galaxy S26 Ultra, SM-S948B) |
| x86_64 | native x86_64 runner | no |
| armv7 | armhf container under qemu-user | no |
Push a tag named uls-<short fork commit>-r<n> (for example
uls-f2cbc4f-r1). CI builds all three architectures and publishes a release
whose title is the tag. The earlier termux-d4d2a19-r1 release was built
from stock termux/proot plus two patches.
proot is free software under the GNU General Public License, version 2.
See COPYING, which comes from upstream unchanged. The build files
here, and the changes in the fork, are distributed under the same licence.
The fork's changes are listed with dates in its ULS-CHANGES.md, and each one
is a separate commit.