madeye / ServerBox

# ServerBox
**Turn a used Android phone into a Linux server, no root required.**
An old phone is a small, quiet, low-power computer with a battery backup and Wi-Fi built in.
ServerBox puts a real Linux distribution on it and keeps an SSH server running, so you can use
it like any other box on your network: host services, run scripts and cron jobs, or tinker.
ServerBox is a fork of UserLAnd by
CypherpunkArmory (UserLAnd Technologies, LLC) and, like UserLAnd, is licensed under the
GPLv3.
## What it does
- **Linux distributions without root.** Alpine, Arch, Debian, Kali and Ubuntu run in user space
 through PRoot. Each one is a headless server image with an SSH server,
 an editor and the usual tools. Install and uninstall ServerBox like any other app.
- **SSH out of the box.** Every session runs an SSH server on port 2022. The Sessions tab shows
 how to connect (`ssh -p 2022 @ `), the user and the password. Turn on
 **Settings → Allow SSH from the network** to reach it from other devices, and add your public
 keys (optionally with **Keys only**).
- **Stays up.** Servers keep running with the screen off and after the app is closed: ServerBox
 holds a wake lock and a Wi-Fi lock, restarts a server that dies unexpectedly, and can restart
 your sessions after a reboot (**Start on boot**).
- **Your services start with it.** Executables in `/etc/serverbox/autostart.d` inside the
 distribution run each time its server starts (logs in `/var/log/serverbox-autostart.log`), which is
 the place for databases, web servers and other daemons in guests without a working init.
- **Phone storage.** Shared storage is available at `/sdcard` inside the distribution; ServerBox
 asks for access to a folder the first time a program uses it.
- **Coding agents, ready to go.** The **Claude** and **Codex** apps are Debian with Anthropic's
 Claude Code or OpenAI's
 Codex CLI preinstalled, along with Node.js, git and ripgrep.
 SSH in and run `claude` or `codex`; you sign in with your own account or API key. 64-bit phones
 only.
- **Virtual machines where supported.** On phones with the Android Virtualization Framework,
 distributions can also run in a real VM through a companion app.
## Screenshots
| Apps | New filesystem | Server settings |
| :---: | :---: | :---: |
| | | |
## Download
Get the APK from Releases. ServerBox needs
Android 8.0 or later. Every distribution is available for 64-bit ARM (nearly all current phones)
and x86_64; 32-bit support varies by distribution.
Releases are signed with this certificate (SHA-256), which you can check with
`apksigner verify --print-certs serverbox- .apk`:
 [code] 
Builds from before 1.0 were signed with a different key, so Android can't update them to a
release: uninstall the old build first. Uninstalling deletes its distributions and sessions.
## Getting started
1. Install ServerBox and open it.
2. Pick a distribution on the **Apps** tab. ServerBox downloads it (the setup log shows each
 step) and opens a terminal.
3. Open the **Sessi