Getting Started

PlainApp is a self-hosted Android application that creates a local web server on your phone. Once started, you can access a full-featured management dashboard from any browser on the same Wi-Fi network.

Install the app from Google Play, F-Droid, or GitHub → Open PlainApp → Tap Start → Open the displayed URL in your browser.

Command line (CLI)

plain-cli in plain-core builds the plainapp executable. Use --help to list commands. Local management verifies the service's OS account and trusts programs with that account's privileges. Use sudo for the installed Linux root service; this cannot protect against programs already able to execute arbitrary root commands.

bash
plainapp --help
plainapp install --help
plainapp run --help
plainapp passwd --help
plainapp login --help
plainapp prefs --help
plainapp status --help
plainapp uninstall --help

Change settings and passwords without stopping the service. prefs requires a running server. status shows the process state, PID and actual HTTP/HTTPS ports; port changes restart only the listeners. passwd uses hidden input and sets the password exactly as entered; when no server is listening, it can initialize the password under the data-directory lock. Use plainapp prefs developer_mode false to disable developer mode. Commands use the exact service --data-dir (Linux default: /var/lib/plainapp), without searching other directories.

bash
sudo plainapp status
sudo plainapp prefs developer_mode true
sudo plainapp prefs allow_any_host true
sudo plainapp passwd

Encryption & Security

PlainApp uses TLS (HTTPS) for all browser connections with XChaCha20-Poly1305 encryption. The P2P chat feature uses XChaCha20-Poly1305 authenticated encryption with Ed25519 digital signatures. Your self-signed certificate means the browser will show a security warning on first visit — this is expected and safe to proceed through.

How to Contribute to PlainApp

Contributions are welcome from everyone. Even small efforts can help PlainApp improve faster.

Localize: Help translate PlainApp into your language via our GitHub.

Feedback: Report bugs, crashes, or suggest new features on Issues.

Spread the Word: Recommend PlainApp to your friends, write a blog post, or create a video tutorial. Every share counts!