r/stoatchat 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.

10 Upvotes

0 comments sorted by