How the app connects
STALMAS zero-backend architecture and how Portainer, SSH, the hybrid AI assistant, and Google Drive interact.
STALMAS is built around one architectural rule: no server of ours sits in the path when you manage your infrastructure. All logic runs on your Android phone.
Direct connections from your phone
[Your Android + STALMAS]
├── HTTPS / private HTTP ────────▶ [Your Portainer CE / BE]
├── SSH TCP + TOFU ──────────────▶ [Your Linux / Docker host]
├── On-device LiteRT-LM ─────────▶ [Zero network · Gemma 4 .litertlm]
├── Optional (your BYOK key) ────▶ [Google Gemini API]
└── Optional (AES-256 archive) ──▶ [Your Google Drive (appDataFolder)]
How secrets are protected at rest
- Encrypted database: structured local data uses SQLCipher v8 (
android-database-sqlcipher). - Encrypted preferences: server tokens, SSH keys, and your Gemini API key live inside hardware-backed encrypted storage (
EncryptedSharedPreferences/ Android Keystore). - OS backup excluded (
allowBackup="false"): the Android manifest explicitly disables standard system backup extraction.
Privacy Gatekeeper before cloud AI calls
Whenever you ask cloud AI (Gemini BYOK) about logs, terminal output, or Docker Compose files:
PrivateInfoDetectorscans outgoing prompts for sensitive values: IPv4/IPv6 addresses, domains, URLs, passwords, keys, tokens, and connection strings.- On Free (and cloud calls), the Gatekeeper applies “redact and send”: it masks each sensitive item with
[REDACTED], sends the request, and shows a notice with how many items were masked plus an option to view what was redacted. - On Pro,
PseudonymMapreplaces IPs and hostnames with reversible placeholders ([IP_1],[HOST_1]) for the request and restores those values locally when the reply arrives; passwords, keys, and tokens are never restored. InAutomode with a local model installed, the prompt is routed on-device instead.
What Google Play handles
Purchases (the one-time Pro payment and tips) and integrity checks are handled directly by Google Play Billing and Play Integrity. STALMAS never sees payment instruments or maintains user accounts.