Overview
Ephemeral Phone is a working control plane for running a persistent Android handset on infrastructure you control and reaching it through temporary clients. The current reference deployment uses Cuttlefish on owner hardware, a protected control plane, GitHub authentication, and WebRTC streaming.
Choose your starting point
Architecture at a glance
Control plane
ephemerald owns lifecycle state, provider selection, audit events, and short-lived connection tickets. The hosted web gateway exposes only an allowlist of those operations.
Runtime node
ephemeral-agent runs beside the Android runtime. The production demonstration uses Cuttlefish; command and remote adapters make the control plane independent of one runtime.
Replaceable client
The PWA and Android WebView shell are thin clients. They are designed not to retain Android application data after a session, although browsers and operating systems may still retain normal metadata such as history, cookies, screenshots, or network records.
Documentation map
- Appliances and images — hardware tiers, capacity acceptance, Android image compatibility, client branding, and ordering.
- Installers and deployment — supported artifacts, source builds, Docker, and runtime requirements.
- Control API — authentication, endpoints, and an example request.
- Privacy zones — optional airport and sensitive-area locking, including its limits.
- Security and trust — what the system protects, what it does not, and how to report a problem.
- Roadmap — completed, experimental, and planned work.