Linux for Alumium
Debian on your phone. Linux programs open in windows on Alumium's desktop, and Alumium's Terminal gets a Debian shell with apt.
- Download
- [release: the add-on's APK]
- Version
- [release: version]
- File SHA-256
- [release: SHA-256 of the APK]
- Signing certificate SHA-256
- [release: SHA-256 of the signing certificate]
- Source code
- [release: the source bundle of this version]
- App ID
com.alumium.linux- Needs
- Alumium from Google Play, Android 13 or newer, a 64-bit ARM phone (arm64-v8a)
- Space
- About 530 MB at first, plus what you install.
What it does
- Linux programs in windows. On Android 14 or newer, each program you install opens in its own window on Alumium's desktop. Closing the window asks the program to quit; any that keep running without a window are listed in the Linux menu, with End.
- A Linux shell. Alumium's Terminal opens Linux tabs that run Debian 13: bash in a full terminal, so full-screen programs such as
nanoandmcwork. - Debian's packages.
aptinstalls from Debian's own archive and checks every package against Debian's signing keys. - No root needed. It runs inside the add-on's own storage using PRoot, which runs Linux programs without root access. Your phone's system is not modified.
- Only Alumium can use it. The add-on opens Linux sessions only for Alumium, and checks on every call that it is talking to a genuine Alumium.
Linux apps
The add-on has its own page, Linux Store, which lists the Linux programs that have been tested with Alumium and installs each one with a tap. You remove a program from its page there, and the add-on asks first. Open programs from Linux Store or from the taskbar.
- Web and mail
- Firefox ESR, Thunderbird
- Office
- LibreOffice Writer, LibreOffice Calc
- Documents
- Document Viewer (Evince), Okular
- Text and code
- Mousepad, FeatherPad, Text Editor (GNOME), Geany, Kate
- Files, pictures and video
- Files (Nautilus), Image Viewer (Loupe), Celluloid
Tested means that each of these fourteen was installed on a fresh setup, opened in a window and closed, on one phone running Android 16. Their menus and buttons are not checked yet.
Install it
- Install Alumium from Google Play, if you haven't.
- On your phone, download the add-on from this page.
- Optional: check the file against the SHA-256 above.
- Open the downloaded file. Android asks whether your browser may install apps: allow it for this install, then tap Install.
- In Alumium, open Terminal and tap Install. The add-on downloads Debian, checks it and sets it up. It reports each step, and you can cancel.
You can switch the browser's install permission off again in your phone's Settings, under Apps, your browser, Install unknown apps.
Where Debian comes from
The add-on doesn't contain Debian. On first setup it downloads the official Debian image (Debian 13, trixie-slim for arm64, built by Debian's debuerreotype) from that project's published files, or from the Docker Hub registry, which serves the identical file. Before unpacking, it checks the download against a SHA-256 fixed inside the add-on:
bbeda6b4abb749f743f4547ef5a28070a14de8caef211daa5afb78d5b5fa21ba
After that, you keep it up to date with apt, as on any Debian system, or with Update in Linux Store. Nothing is installed unless you ask.
Remove it
Remove Linux on the Linux page of Terminal's settings, which deletes Debian and everything installed in it, or uninstall the add-on like any other app. Alumium keeps working, with Android's own shell in Terminal.
Source code and licences
Besides our own code, the add-on carries this free software. The add-on's About screen lists the same, with every licence text in full.
- PRoot 5.1.107.102 (Termux's maintained version), which runs Linux programs without root. Licensed under the GNU GPL version 2 or later; because talloc is built into it, the PRoot program in the add-on is distributed under the GNU GPL version 3. We changed it in nine places, each marked in the files it touches. Copyright © 2015 STMicroelectronics and contributors.
- talloc 2.4.4, the memory allocator built into PRoot, licensed under the GNU LGPL version 3 or later. Copyright © 2004–2005 Andrew Tridgell, © 2006 Stefan Metzmacher.
- libwayland-server 1.23.1, in the add-on's display server for Linux windows, with the code of the xdg-shell, viewporter, xdg-decoration, relative-pointer, pointer-constraints and keyboard-shortcuts-inhibit protocols, all under the MIT License (Wayland, xdg-shell, viewporter, xdg-decoration, relative-pointer, pointer-constraints, keyboard-shortcuts-inhibit), and of the text-input protocol, under its own permission notice. We changed libwayland in two places.
- libffi 3.4.8, used by libwayland-server, under the MIT License. It includes dlmalloc by Doug Lea, public domain.
- libxkbcommon 1.7.0, which builds the keyboard layout Linux programs receive, under MIT-style licences.
- libusb 1.0.30, which the add-on puts inside Debian so Linux programs see the USB devices you share with them. Licensed under the GNU LGPL version 2.1 or later, with one change of ours under the same licence. Its build links small runtime files from glibc and GCC, each under its own link exception.
- xwayland-satellite 0.8.3, which runs inside Debian and shows the windows of programs that only speak X11. Licensed under the Mozilla Public License 2.0, with two changes of ours under the same licence. The 128 Rust libraries of other projects built into it are each under MIT, Apache 2.0, BSD, ISC, Zlib, Unlicense, 0BSD or Unicode-3.0 terms; the About screen shows each one's notice.
The add-on's own code uses the Kotlin standard library (Apache License 2.0), and Linux Store's icons are Material Symbols (Apache License 2.0). Debian's packages carry their own licences, listed inside Linux under /usr/share/doc/<package>/copyright, and Debian publishes their sources. Debian is a registered trademark of Software in the Public Interest, Inc. Firefox and Thunderbird are trademarks of the Mozilla Foundation, and LibreOffice is a trademark of The Document Foundation. Other program names belong to their owners.
Written offer
Each release of the add-on publishes, on this page beside the download, the complete corresponding source of PRoot, talloc and libusb as built into it: the original source archives, our patches, our build scripts, and build instructions that rebuild the same files. The same bundle carries our changes to xwayland-satellite and its build files; its own source is the public release tag named below. For at least three years after we last distribute a version, we will also give that source to anyone who asks at support@alumium.app, charging no more than the cost of providing it.
Upstream sources
- PRoot
github.com/termux/proot, tagv5.1.107.102, archive SHA-25630d12a6e2cc4147123756ff58edea262d3083bbc238c12d0ab9b39e3d1c40852- talloc
samba.org/ftp/talloc/talloc-2.4.4.tar.gz, SHA-25655e47994018c13743485544e7206780ffbb3c8495e704a99636503e6e77abf59- libwayland
deb.debian.org/debian/pool/main/w/wayland/wayland_1.23.1.orig.tar.gz, SHA-256158ec49af498f2558c7fbf7e8b070d010d4e270cc6076003a18a6c813f87e244- libffi
deb.debian.org/debian/pool/main/libf/libffi/libffi_3.4.8.orig.tar.gz, SHA-256cbb7f0b3b095dc506387ec1e35b891bfb4891d05b90a495bc69a10f2293f80ff- libxkbcommon
deb.debian.org/debian/pool/main/libx/libxkbcommon/libxkbcommon_1.7.0.orig.tar.xz, SHA-25665782f0a10a4b455af9c6baab7040e2f537520caa2ec2092805cdfd36863b247- libusb
github.com/libusb/libusb/releases/download/v1.0.30/libusb-1.0.30.tar.bz2, SHA-256fea36f34f9156400209595e300840767ab1a385ede1dc7ee893015aea9c6dbaf- xwayland-satellite
github.com/Supreeeme/xwayland-satellite, tagv0.8.3, archive SHA-2568b32873d7d740143ce9efa3cfb43c17d0176b89d2e8ffaa497db709f154fc478- Licence texts
- GPL 3.0 · GPL 2.0 · LGPL 3.0 · LGPL 2.1 · MPL 2.0 · Apache 2.0