Hosted mode: run the frontend from its own site and pick an instance #3583

Merged

hj merged 3 commits from feat/hosted-mode into develop

2026-10-06 19:45:42 +00:00

lambadalambda commented

2026-10-06 08:50:15 +00:00

Owner

With "hosted": true in static/config.json, the frontend can be served from any static host. On first load it asks for an instance, then talks to it directly (CORS):

One API base for all requests, the streaming socket, emoji and instance files (src/api/api_base.js). An empty base means the page is the instance, so nothing changes for normal installs.
Instance picker before boot. Login goes through the instance's OAuth page, and the login form can change the instance.
Pleroma refuses WebSockets from other origins. The hosted app falls back to polling after three failed opens and shows no notice. The shoutbox and web push stay off in hosted mode.

Tested with a build served by vite preview against lain.com and fediffusion.art (picker, boot, timeline, OAuth redirect, change instance), and without hosted mode through the dev proxy.

Known gaps in hosted mode: the admin-fe link in settings points at the hosted site, and web push is off.

With `"hosted": true` in `static/config.json`, the frontend can be served from any static host. On first load it asks for an instance, then talks to it directly (CORS): - One API base for all requests, the streaming socket, emoji and instance files (`src/api/api_base.js`). An empty base means the page is the instance, so nothing changes for normal installs. - Instance picker before boot. Login goes through the instance's OAuth page, and the login form can change the instance. - Pleroma refuses WebSockets from other origins. The hosted app falls back to polling after three failed opens and shows no notice. The shoutbox and web push stay off in hosted mode. Tested with a build served by `vite preview` against lain.com and fediffusion.art (picker, boot, timeline, OAuth redirect, change instance), and without hosted mode through the dev proxy. Known gaps in hosted mode: the admin-fe link in settings points at the hosted site, and web push is off.

lambadalambda added 3 commits

2026-10-06 08:50:15 +00:00

feat(api): one API base for every request 206d826bba

Requests, the streaming socket and emoji go through apiUrl/streamingUrl;
empty base (the page is the instance) leaves paths as they were.

feat(hosted): pick an instance and log into it from another site b7f3329009

With "hosted": true in the site's static config, the boot asks for an
instance first, then runs against it: instance files and paths come from
it, login uses its OAuth page, and the login form can change it.

feat(hosted): poll when the instance refuses sockets; no shout or push

ci/woodpecker/pr/build Pipeline was successful

Details

ci/woodpecker/pr/changelog Pipeline was successful

Details

ci/woodpecker/pr/lint Pipeline was successful

Details

ci/woodpecker/pr/test Pipeline was successful

Details

ci/woodpecker/pr/test-e2e Pipeline was successful

Details

5f7bd67ddd

Pleroma refuses sockets from other sites: after three that never opened
the hosted app stops asking, without notices. The shoutbox socket and web
push stay off on the hosted site.

hj commented

2026-10-06 19:45:24 +00:00

Member

i'm gonna add some nginx snippets and improve config.json logic (or just make a build argument?) later to make deployment easier

For now it's deployed onto https://fe.pleroma.dev/ and I upload and modify build manually over SFTP

i'm gonna add some nginx snippets and improve config.json logic (or just make a build argument?) later to make deployment easier For now it's deployed onto https://fe.pleroma.dev/ and I upload and modify build manually over SFTP

hj merged commit 2c4192c544 into develop

2026-10-06 19:45:42 +00:00

hj deleted branch feat/hosted-mode

2026-10-06 19:45:43 +00:00

hj referenced this pull request from a commit

2026-10-06 19:45:43 +00:00

Merge pull request 'Hosted mode: run the frontend from its own site and pick an instance' (#3583) from feat/hosted-mode into develop