Documentation · Understand

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:

  1. PrivateInfoDetector scans outgoing prompts for sensitive values: IPv4/IPv6 addresses, domains, URLs, passwords, keys, tokens, and connection strings.
  2. 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.
  3. On Pro, PseudonymMap replaces 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. In Auto mode 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.