mikedmor

Muny for Android

Set up Muny

Muny is personal finance and subscriptions on your own hardware. The app connects to your Muny: set that up first, then point the app at it.

1. Run Muny at home

Muny is one Docker container (a PC, a NAS or a Raspberry Pi all work). Follow the install guide, then open it in a browser and create the owner account.

Want to look around first? Start it once with MUNY_DEMO=true and it fills itself with a made-up household.

2. Give it an https address your phone trusts

The app only connects over https://. Either works:

More detail: Access from your phone and other devices.

3. Connect the app

  1. Install Muny from Google Play (coming soon) and open it.
  2. Enter your Muny address, like https://muny.home, and tap Connect. The app checks it really is Muny.
  3. Sign in with your Muny account. You'll be asked for your fingerprint or screen lock each time the app opens (you can turn that off under Server and lock: press and hold the app's icon).

Notifications

In the app, go to Alerts → Settings → Turn on notifications here and allow notifications. Then pick which alerts this phone gets, and try Send test.

Nothing to set up on your server and nothing else to install: alerts arrive through Google Play services. Your Muny encrypts each one for your phone before it leaves, so the relay that passes it on and Google only ever see scrambled data. To turn app notifications off for your whole Muny, set MUNY_PUSH_RELAY=off.

Offline

In the app, Muny keeps an encrypted copy of the pages you've visited, so it still opens, read-only, when your server can't be reached. Turn it off under Settings → This device if you prefer. It's deleted when you sign out.

If something's wrong

The app saysWhat to do
The certificate isn't trustedInstall your home's root certificate on the phone (step 2), or use your Tailscale address.
Couldn't find that addressCheck the spelling, and that the phone is on your home network or Tailscale.
It doesn't look like MunyThe address reaches something else: check the port and the reverse proxy.
Can't reach MunyThe server or your connection is down. Pages you've opened before still show.