# 01 — Fresh Termux install (Android)

This guide covers a clean Termux install **without** Google Play, which is required for Termux:API / Termux:Boot compatibility.

## Why not Google Play

Google Play freezes Termux on an old version. Addons (Termux:API, Termux:Boot, Termux:Widget) require signature parity with the base app, so the Play version is incompatible with the F-Droid / GitHub-Release addons.

**Decision:** install everything from F-Droid or GitHub Releases (Termux team's official builds).

## Recommended source

Use one of:
- [F-Droid](https://f-droid.org/en/packages/com.termux/) — auto-updates, signed by F-Droid
- [GitHub Releases](https://github.com/termux/termux-app/releases) — latest, signed by the Termux team

Both share the same signing key, so addons work across them. **Don't mix Play and F-Droid/GitHub.**

## APK list (download to the device beforehand)

| Package | Purpose | Required |
|---------|---------|----------|
| `termux-app_*.apk` | Base shell | yes |
| `termux-api-app_*.apk` | Sensors, camera, clipboard | recommended |
| `termux-boot-app_*.apk` | Auto-start on boot | optional |
| `termux-widget-app_*.apk` | Home-screen launchers | optional |

## First boot

```bash
# 1. Allow Termux access to shared storage (~/storage symlink)
termux-setup-storage

# 2. Prevent Android from killing the process when screen is off
termux-wake-lock

# 3. Update and install the minimum
pkg update -y
pkg install -y openssh nodejs git proot python
```

## SSH for remote access (optional but useful)

```bash
passwd        # set an SSH password
sshd          # start the daemon on port 8022
whoami        # note the u0_a*** username for remote login
```

From another machine:
```bash
ssh -p 8022 u0_a***@<device-ip>
```

If the device is on Tailscale, use the Tailscale IP instead of the LAN one. Termux itself can't run the Tailscale CLI; use the Android Tailscale app and the device will appear in your tailnet automatically.

## What's next

Continue with `02-base-packages.md` to install the rest of the stack used by Claude Code and helper scripts.