How to use multiple Happier servers from your phone (work / personal)
Keep work/personal (or cloud/self-host) sessions separate, and avoid the “wrong server” confusion when opening links and notifications on mobile.
- CLI
- 0.1.0
- Preview ref
- f36aa45
I started using multiple Happier servers pretty early (cloud + a self-host, and later a work server), and I hit the same confusion everyone hits:
A link opens, a notification pops, and you’re suddenly thinking:
- “Wait — which server am I on right now?”
- “Why are my sessions gone?”
- “Why did that connect flow send me to Server settings?”
This is the workflow that made multi-server feel predictable from my phone.
TL;DR
- Treat each server as a separate “profile”: auth and sessions are server-scoped.
- When something looks missing, you’re usually just on the wrong server.
- Notifications/links are designed to not silently trust new servers; that’s why you sometimes land in Server settings.
What I mean by “multiple servers from your phone”
I mean you have more than one API/webapp target saved on your phone, for example:
- Happier Cloud
- your personal self-host
- a work/company self-host
…and you want to switch between them without losing your mind.
What I tried first (and where I bounced off)
-
One server only: simplest, but not realistic if you want work/personal separation.
-
Bookmark different URLs: works, but I’d constantly end up in the wrong place after notifications.
-
Happier: has explicit server profiles and link handling that tries to keep you safe (it won’t silently add/trust a new server). Trade-off: you have to accept that “server switching” is a real part of the mental model.
If you’re new to Happier (what it is, and where to get it)
If you haven’t seen Happier before: it’s an open-source companion app (mobile/web/desktop) for AI coding agents like Claude Code, Codex, and OpenCode.
The session still runs on a machine you trust (laptop/server/dev box). Happier is where you monitor, steer, approve, review, and keep going from your phone.
Get set up:
- How to run Happier from your phone
- GitHub: https://github.com/happier-dev/happier
- Install/download: https://github.com/happier-dev/happier#how-it-works
- Discord (community + support): https://discord.gg/W6Pb8KuHfg
The model that makes multi-server predictable
Three rules explain most “wtf just happened” moments:
- A server profile is a saved API/webapp target.
- Auth is scoped per server (logging into server A doesn’t log you into server B).
- Your sessions are scoped per server (so switching servers can make your session list look empty).
Once you internalize those, most confusion turns into: “I’m on the wrong profile.”
Step-by-step: add and switch servers on your phone
- Open Server settings.
- Add/select/rename your server profiles.
- Sign in on the server you actually want to use.
On web, note that server selection can be per-tab or a device default.
What happens when you open a link or notification
Happier handles incoming links based on whether the server is already saved on the device.
Case 1: the target server is already saved
- Happier can switch to that server profile and continue.
Case 2: the target server is not saved (but you already have saved servers)
- Happier opens Server settings with the incoming URL prefilled.
- You explicitly choose Add & Use.
This is intentional: it prevents the app from silently trusting a new server in the background.
Troubleshooting
Symptom: I switched servers and my sessions disappeared
Likely cause:
- those sessions belong to another server profile
Fix:
- switch back to the original server
Symptom: A notification sent me to Server settings
Likely cause:
- that notification came from a server URL that isn’t saved on this device yet
Fix:
- add the server from the prefilled form, then continue to the intended session