Self-host Soapbox
v3.2.0White-label Fediverse frontend for Mastodon API servers
What is Soapbox?
Soapbox FE is the browser client you serve from your own Fediverse server: it speaks the Mastodon API, so it can front Mastodon, Pleroma, Akkoma, GoToSocial and other compatible backends, and it can also be pointed at any such domain straight from the browser. Its design goal is white-labelling, meaning visitors see your site's name and logo rather than the client's own brand, supported by an admin configuration screen, logo and theme settings, and built-in moderation tooling. Deploying it means unpacking a static build onto your web server, either into a Pleroma instance's static directory or behind Nginx in front of Mastodon, where the backend is used only as an API. Compile-time options cover a custom/ directory, environment variables such as BACKEND_URL and FE_SUBDIRECTORY, per-build feature toggles, locale message overrides and custom HTML about pages. Because the frontend knows nothing about the backend, plain static hosting loses link previews, which the maintainers solve with a companion Cloudflare Worker project. The code is AGPL-3.0 and credits its lineage from Gab Social's and Mastodon's frontends. Development attention has moved to Ditto, the successor project; Soapbox FE remains available as a classic Fediverse frontend, with its most recent tagged release at v3.2.0.
Soapbox alternatives
Masto-FE StandaloneOpen-source, self-hosted fork of the Mastodon web frontend that runs against GoToSocial instances and keeps tokens and passwords only in browser local storage.CompareMasto-FE Standalone with Soapbox
MastodonOpen-source self-hosted microblogging server that federates over ActivityPub, with chronological timelines, media posts, moderation tools and an OAuth2 REST API.CompareMastodon with Soapbox
PhanpyPhanpy is a self-hosted, open-source Mastodon web client with a minimalistic design, multi-account support, nested threads, and multi-column layouts.ComparePhanpy with Soapbox
Glitch-SocMastodon Glitch Edition is a self-hosted, open-source ActivityPub microblogging server adding experimental features like Markdown posts and advanced theming to Mastodon.CompareGlitch-Soc with Soapbox
ElkNimble open-source self-hosted Mastodon web client with PWA support. Docker container deployment behind SSL/TLS for users seeking an alternative interface.CompareElk with Soapbox- GoToSocialSelf-hosted, open-source ActivityPub social server in Go: chronological timelines, Mastodon-API clients, SQLite or Postgres, Markdown posts, granular privacy.CompareGoToSocial with Soapbox
snacSelf-hosted, open-source ActivityPub server written in portable C that runs your own small Fediverse instance: multi-user, no database needed, Mastodon API support.Comparesnac with Soapbox
PleromaPleroma is a lightweight fediverse server compatible with other Fediverse software such as Mastodon, Misskey, and Pixelfed.ComparePleroma with Soapbox
Should you self-host Soapbox?
Soapbox scores 58/100 on selfhost.directory (how scoring works) and ranks #26 of 75 in Social Networks & Forums.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is moderate: expect some configuration beyond a single command. It is agpl-3.0-licensed.
Its closest alternative on selfhost.directory is Mastodon (84/100, 50 557 stars). It scores higher overall, so compare the two before you pick. See Soapbox vs Mastodon side by side.
Features
- Admin configuration UI
- Automatic OAuth app registration
- Custom about pages
- Custom head snippets
- Custom site branding
- External client mode
- Locale message overrides
- Moderation tools
- Per-build feature toggles
- Static-file hosting
How to install Soapbox
Install Soapbox with Build from Source
NODE_ENV, BACKEND_URL, FE_SUBDIRECTORY, SENTRY_DSNcurl -O https://dl.soapbox.pub/main/soapbox.zip
busybox unzip soapbox.zip -o -d /opt/soapbox
The main part of the URL can be replaced with any git ref, eg v2.0.0. Custom builds are usually produced by forking on GitLab and letting GitLab CI build them.
More in Social Networks & Forums
SocialhomeSelf-hosted federated social networking server using ActivityPub and Diaspora protocols for decentralized content sharing across the fediverse.
storydenSelf-hosted open-source forum and knowledge library for communities to own their conversations and data with optional AI features.- StreamsDecentralised fediverse server with permission-based privacy controls. Compatible with Mastodon, Pleroma, Pixelfed, Friendica, Hubzilla ActivityPub federated services.
strfrystrfry is a self-hosted, open-source Nostr relay in C++ using LMDB with negentropy sync and Prometheus metrics.
SymphonySelf-hosted open-source Java community platform for forums, Q&A and social networking, with a big admin backend, themes and a Docker image.
TakahēSelf-hosted open-source ActivityPub server for microblogging with multi-domain and multi-identity support, Mastodon API compatible.
TalkyardSelf-hosted open-source community platform combining forum, chat, Q&A, and blog comments — alternative to StackOverflow, Slack, Discourse, Reddit, Disqus.
tedditOpen-source, self-hosted Reddit front-end that strips JavaScript, ads and tracking, and serves an unofficial RSS and JSON API; no longer actively maintained.
tiesties is a self-hosted, open-source federated bookmark manager for organizing, sharing, and discovering web pages via ActivityPub federation.
tootiktootik is a self-hosted, open-source federated social network with a Gemini protocol frontend, interoperating with Mastodon, Lemmy, and other ActivityPub platforms.- UBOSUBOS is a Linux distribution and platform for easily deploying, managing, and running self-hosted web applications on user-controlled servers. It provides tools (UBOS Gears) to install and manage apps like Mastodon, Nextcloud, and WordPress, along with middleware (UBOS PeerGraph) for social web interoperability.
valourValour is a self-hosted, open-source Discord alternative offering end-to-end encrypted chat, voice, threads, wikis, and 2D villages with native apps.
0 comments