Haven
5.94.52 · GitHub
More about this app
Terminal, SSH, VNC, RDP, SFTP & cloud storage client for Android
Haven
Free, open-source remote access & mobile workspace for Android —
SSH · Mosh · VNC · RDP · SPICE · GLKVM · SFTP · SMB · email · cloud storage, a local Linux shell and a full Linux kernel (UML), mesh networking, and a consent-gated AI-agent endpoint
"Haven is an interesting vibe coding experiment. Let's see what comes out of it." — DBP
▶ Watch: the terminal — and every Haven screen — made translucent over the device wallpaper (new in 5.60.4). Live wallpaper: MagicFluids.
At a glance
- Terminal — Mosh / Eternal Terminal / SSH, USB / Bluetooth / BLE serial consoles with a serial↔TCP bridge, tmux-aware session restore, configurable keyboard toolbar, OSC 7/8/9/52/133/777 integration.
- Desktops — VNC (RFB 3.8 / VeNCrypt), RDP (IronRDP + EGFX), SPICE (QEMU/KVM, GLZ/QUIC), GLKVM / PiKVM out-of-band HDMI+HID, a GPU-accelerated native Wayland compositor, and a multi-distro local-desktop manager.
- Files & cloud — unified browser for SFTP/SCP, SMB, and 60+ cloud providers; cross-filesystem copy/move, editor and image tools; plus on-device FFmpeg transcode, HLS streaming, and DLNA.
- Connections — port forwarding (-L/-R/-D/-J), SOCKS/HTTP/Tor proxies, per-app WireGuard, Tailscale, NetBird & Cisco AnyConnect tunnels, port knocking and fwknop SPA, and SSH keys (incl. FIDO2/SK).
- Email — ProtonMail (bridge protocol) and any IMAP/SMTP mailbox; compose / reply / forward, multi-account, attachments; plus Mail Rules inbound automation.
- AI chat — chat with self-hosted or API models (OpenAI-compatible, Ollama, Anthropic, Gemini) over per-profile tunnel routing; image attach for vision models, clipboard copy/paste both ways, opt-in encrypted saved transcripts.
- Local Linux — a Linux userland via PRoot (no root, any Android 8+ device): Alpine, Debian, Ubuntu, Arch, or Void, side-by-side.
- Linux Guest (UML) — a whole Linux kernel (user-mode Linux) booted as an app process on any arm64 device, no root: Alpine with
apk, its own ext4 disk and network stack, for when PRoot's syscall emulation isn't enough. - USB card rescue console — plug in a failing SD card and the raw device reaches a Linux guest in seconds, ready for
ddrescue; the rescued image lands in app storage. - USB forwarding — broker an attached USB device through Android and re-expose it to the agent, into the Linux guest, or over USB/IP to a remote host (e.g. a phone-hosted YubiKey, touch on the phone).
- Reticulum — rnsh shell, file transfer, and
-L/-Dport forwarding over Reticulum mesh, pure Kotlin. The one transport that keeps working with no internet at all. - Agent transport (MCP) — an optional MCP server exposing ~230 consent-gated, audited tools — including on-device RapidOCR + 2D k-d tree spatial indexing for driving remote desktops (VNC, RDP, SPICE, GLKVM) and tools to see and operate Haven itself for a self-hosting build → install → verify loop.
- Security — biometric lock, no telemetry, encrypted backup/restore (AES-256-GCM).
See docs/FEATURES.md for the full feature index.
Why one app
The list above is the parts; the point is how they compose. Each of these is one
flow inside Haven — no second app, no curl | ssh incantation:
- Tap a 4K MKV in Google Drive → FFmpeg transcodes it over HTTP and the result lands back in the same Drive folder, never touching local disk.
- SSH to a box, forward its port, tap the VNC profile that targets
localhost— the desktop opens in the same app, keyboard and clipboard shared. - Cut a log directory from an S3 bucket, switch tabs, paste it onto an SFTP server — rclone does the server-side copy when it can, otherwise Haven streams it through.
- Run your agent CLI in the on-device Linux shell; it pushes over the SSH agent you forwarded from your laptop while you watch on the same screen.
- Hit something PRoot can't do — a tracer, a mount, a script you don't trust — and boot the UML guest instead: a real kernel as an app process, which an agent can drive over the same MCP tools.
- Cast a cloud video to the TV across the room over HLS, copy the LAN URL from the snackbar, send it to a friend so they can watch too.
The phone is the thin client, Haven is the thin-client OS, and the cloud, your servers, and your agents are the computer. Width is sufficient; composition is the point. (Vision.)
Languages
Available in 12 languages: English, Chinese (simplified), Spanish, Hindi, Arabic (with RTL support), Portuguese, Bengali, Russian, Japanese, Korean, French, and German. The UI follows the device language.
Want to help translate? Improve a translation or add a new language straight from the web translation page — no cloning or setup; your changes become a GitHub pull request. See Languages & translation for details.
Install
| Channel | |
|---|---|
| GitHub Releases | Signed APK, all features |
| F-Droid | Built from source, all features |
Both builds have the same features — SSH, Mosh, Eternal Terminal, VNC, RDP, SFTP, SMB, email, and cloud storage. IronRDP (Rust) is built from source via cargo-ndk. rclone (Go) is built from source via gomobile.
Pick one channel and stay on it. The two channels are signed with different keys — GitHub Releases use Haven's own release key; F-Droid builds from source and signs with F-Droid's per-app key. Android treats different signing keys as different apps, so you can't update in place from one channel to the other — switching means uninstall + reinstall, which clears app data (back up first via Settings → Backup). Direct sideloads and Obtainium track the GitHub Releases key.
Signing certificate SHA-256 (to verify a sideloaded APK with
apksigner verify --print-certs):
- GitHub Releases:
ea03a3a70e1c11d0a78932f959b21f20d8735d9cd750997657cb7f7d7c2b90b3- F-Droid:
ea05a89431961b8ac53c36725452673c2be1c2d7b6e48771617b974e6092b332
Build from source
Requires Rust with Android targets, cargo-ndk, Go 1.26+, and gomobile:
# Rust (for RDP)
rustup target add aarch64-linux-android x86_64-linux-android
cargo install cargo-ndk
# Go (for rclone cloud storage)
go install golang.org/x/mobile/cmd/gomobile@latest
go install golang.org/x/mobile/cmd/gobind@latest
git clone --recurse-submodules https://github.com/GlassHaven/Haven.git
cd Haven
./gradlew assembleDebug
Output: app/build/outputs/apk/debug/haven-*-debug.apk
Documentation
- Features — detailed feature descriptions.
- Backup file format — wire format, the PBKDF2/AES-GCM envelope, and a Python recipe for manual decryption if the in-app importer fails.
- Maintainer Protocol — the
/maintainskill driving Haven's maintenance loop (CI triage, release readiness, issue response, and dependency tracking) run by Qwen3.8-Flash running locally via llama-claude, with daily security audit passes performed by GLM5.3-flash. - Release process — versioning, tagging, and F-Droid steps.
- Privacy policy.
- Vision.
Third-party libraries
| Library | Purpose | License |
|---|---|---|
| rclone | Cloud storage engine (60+ providers) | MIT |
| IronRDP | RDP protocol (Rust/UniFFI) | MIT / Apache-2.0 |
| JSch | SSH/SFTP protocol | BSD |
| smbj | SMB/CIFS protocol | Apache-2.0 |
| ConnectBot termlib | Terminal emulator | Apache-2.0 |
| reticulum-kt | Reticulum mesh network transport (Kotlin) | MPL-2.0 |
| rnsh-kt | Reticulum remote shell client (Kotlin) | AGPL-3.0 |
| FFmpeg | Media conversion and streaming | LGPL-2.1 / GPL-2.0 |
| PRoot | Local Linux shell (userspace chroot) | GPL-2.0 |
| Linux UML | Linux Guest kernel (real kernel as an app process) | GPL-2.0 |
| passt | Guest networking (userspace TCP/IP for the UML guest) | GPL-2.0 |
| labwc | Wayland compositor (native desktop) | GPL-2.0 |
| wlroots | Wayland compositor library | MIT |
| virglrenderer | GPU virtualization (OpenGL passthrough to PRoot apps) | MIT |
| RapidOCR / ONNX Runtime | On-device OCR for desktop & document tools (PP-OCRv5 mobile) | Apache-2.0 / MIT |
| Jetpack Compose | UI toolkit | Apache-2.0 |
Backing
Haven sits on top of the projects listed in the table above — the heavy lifting was done long before this repo existed.
Most of the direction Haven has taken has come from the user base, not from a roadmap: bug reports, screenshots of edge cases, "have you tried…” comments on long issue threads. Qwen3.8-Flash running locally writes most of the actual code; the maintainer's role is closer to that of a messenger between the user group and the model: listening, setting the agenda, and quality-checking.
A small recurring amount comes in via Ko-fi and Liberapay. It helps offset the electricity costs of running the work above, and it's a clear signal that the work is useful to people. The project continues regardless of donations.
License
How Shizuku is used
Can run a privileged terminal, install apps, read logs, manage ADB and grant access via `Shizuku shell and user service`.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Haven uses Shizuku to run a privileged shell and fixed system commands for its terminal, installer, diagnostics and device tools.
- Run privileged terminal: Open a local terminal tab that runs an interactive login shell with elevated shell privileges compared with a normal app terminal.
- Install apps silently: Install an APK downloaded from a link or from connected storage with the
pm install -Sshell command through Shizuku. - Read system logs: Read recent Android logs filtered by app, process or time with the
logcatshell command through Shizuku, and record extended logs to a file in Downloads with thelogcatshell command through Shizuku. - Share Linux desktop: Publish the built in desktop display socket under shared temporary storage with file system shell commands through Shizuku so external clients can connect, with cleanup on stop.
- Reach local virtual machine: Relay a local port to the on device terminal virtual machine with a
socatrelay started through Shizuku, and stop it when done. - Enable wireless and network ADB: Turn on wireless debugging with the
cmd settingsshell command through Shizuku, and enable classic ADB over TCP on a loopback port with system property and service control shell commands through Shizuku. - Grant location and sensor access: Grant location and sensor related runtime permissions for agent tools with the
pm grantshell command through Shizuku when the permission is missing. - Read notifications: Enable notification listener access with the
cmd notificationshell command through Shizuku so recent notifications can be read. - Keep connections running: Apply battery optimization exemption with the
cmd deviceidleshell command through Shizuku so background connections stay alive.
Android APIs or commands used
pm install -Spm list packages -Upm grantlogcat -clogcat -v threadtimelogcat -d -tcmd settings put global adb_wifi_enabledcmd settings get global adb_wifi_portsetprop service.adb.tcp.portsetprop ctl.restart adbdgetprop service.adb.tcp.portstop adbdstart adbdcmd notification allow_listenercmd deviceidle whitelistmkdir -pchmod 0755ln -srm -fsocat TCP-LISTENVSOCK-CONNECTpkill -f
Notable details
Installs still work without Shizuku by opening the standard Android installer for a tap to confirm. Log recording without Shizuku captures only the app own logs.
Changelog
What's new for version 5.94.52
- Fix USB/IP device forwarding stalling when the host keeps an interrupt endpoint polled (for example a forwarded SDR's RNDIS network function): idle IN polls now yield the shared connection lock and complete zero-length reads, so control and data transfers no longer time out (#854).
Which APK?
haven-<version>-<abi>-release.apk — the full app, and what F-Droid
carries. If in doubt, take this one.
haven-<version>-<abi>-terminal-release.apk — the same app with the
desktop and media parts left out, for people who only use Haven for SSH,
terminals, files and storage. Less than half the size on arm64. It drops
RDP and SPICE remote desktop, the native Wayland desktop, and ffmpeg — so
no media conversion, and no video previews or streaming in the file
browser. VNC is kept, so a Linux desktop running inside Haven's guest
still works.
Both are signed with the same key and carry the same version number, so you can install either over the other without losing connections, keys or your Linux guest. The shared version number does mean an updater will not offer to move you between them — switching is a deliberate download.
<abi> is your device's CPU: arm64 for essentially every modern phone,
armv7 for older 32-bit devices, x64 for emulators.
Full Changelog: https://github.com/GlassHaven/Haven/compare/v5.94.51...v5.94.52
Permissions
25 permissions requested
Sources
4 sources
Sources
4 sources