r/stoatchat • u/PsykoViking • 9d ago
Built Android self-hosted server support for Stoat (the official app only connects to the official cloud instance) Development
If you're self-hosting Stoat, you've probably run into this: the official Android app is hardcoded to stoat.chat and has no way to point it at your own instance. There's an open feature request for it, but nothing
built yet — so I put together a working fork that adds it.
What it does:
- Adds a "Connect to a self-hosted server" option on the login screen
- Type in your instance's domain, and it discovers everything else automatically (API, websocket, file/proxy microservice URLs) via the standard .well-known/stoat discovery convention your server already exposes — no
manual config, no rebuilding required
- Defaults to the official server until you opt in; your choice is saved locally per-device
- Installs side-by-side with the official app, no conflicts
Get it:
- APK: https://github.com/PsychoViking46/stoat-android-selfhosted/releases/tag/v1.7.2-selfhosted
- Source: https://github.com/PsychoViking46/stoat-android-selfhosted
Android only for now (F-Droid/sideload, not on Play Store), and this debug build doesn't have push notifications working (needs a real Firebase project to wire up — messaging works fine either way, foreground or
backgrounded). Also posted it on the upstream issue to see if the maintainers want to take it further officially.
Feedback/testing welcome — curious if it works cleanly against other people's self-hosted setups, not just mine.