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.
plainapp --help
plainapp install --help
plainapp run --help
plainapp passwd --help
plainapp login --help
plainapp prefs --help
plainapp status --help
plainapp uninstall --helpChange 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.
sudo plainapp status
sudo plainapp prefs developer_mode true
sudo plainapp prefs allow_any_host true
sudo plainapp passwdEncryption & 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.