# Soapbox

> This open-source, self-hosted Fediverse web frontend swaps a Mastodon or Pleroma server's default UI for custom branding and moderation tools; Ditto is its successor.

- **Category:** [Social Networks & Forums](https://selfhost.directory/social-networks-forums)
- **Licence:** agpl-3.0
- **Source model:** Open source
- **Latest version:** v3.2.0
- **Author:** Alex Gleason
- **Platforms:** Build from Source
- **Requires:** Pleroma (optional), Mastodon (optional)
- **Tags:** Nginx, I18n, Moderation, Fediverse, Mastodon api, Single Page App, Static Hosting

## 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.

## Should you self-host Soapbox?

Soapbox scores **58/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#26 of 75** in [Social Networks & Forums](https://selfhost.directory/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](https://selfhost.directory/project/mastodon) (84/100, 50 557 stars). It scores higher overall, so compare the two before you pick. [See Soapbox vs Mastodon side by side.](https://selfhost.directory/compare/mastodon-vs-soapbox)

## 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

Environment variables:

```
NODE_ENV, BACKEND_URL, FE_SUBDIRECTORY, SENTRY_DSN
```

curl -O https://dl.soapbox.pub/main/soapbox.zip

busybox unzip soapbox.zip -o -d /opt/soapbox

Note: 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.

## Soapbox alternatives

- [Masto-FE Standalone](https://selfhost.directory/project/masto-fe-standalone): Open-source, self-hosted fork of the Mastodon web frontend that runs against GoToSocial instances and keeps tokens and passwords only in browser local storage. (compare: https://selfhost.directory/compare/masto-fe-standalone-vs-soapbox)
- [Mastodon](https://selfhost.directory/project/mastodon): Open-source self-hosted microblogging server that federates over ActivityPub, with chronological timelines, media posts, moderation tools and an OAuth2 REST API. (compare: https://selfhost.directory/compare/mastodon-vs-soapbox)
- [Phanpy](https://selfhost.directory/project/phanpy): Phanpy is a self-hosted, open-source Mastodon web client with a minimalistic design, multi-account support, nested threads, and multi-column layouts. (compare: https://selfhost.directory/compare/phanpy-vs-soapbox)
- [Glitch-Soc](https://selfhost.directory/project/glitch-soc): Mastodon Glitch Edition is a self-hosted, open-source ActivityPub microblogging server adding experimental features like Markdown posts and advanced theming to Mastodon. (compare: https://selfhost.directory/compare/glitch-soc-vs-soapbox)
- [Elk](https://selfhost.directory/project/elk): Nimble open-source self-hosted Mastodon web client with PWA support. Docker container deployment behind SSL/TLS for users seeking an alternative interface. (compare: https://selfhost.directory/compare/elk-vs-soapbox)
- [GoToSocial](https://selfhost.directory/project/gotosocial): Self-hosted, open-source ActivityPub social server in Go: chronological timelines, Mastodon-API clients, SQLite or Postgres, Markdown posts, granular privacy. (compare: https://selfhost.directory/compare/gotosocial-vs-soapbox)
- [snac](https://selfhost.directory/project/snac): Self-hosted, open-source ActivityPub server written in portable C that runs your own small Fediverse instance: multi-user, no database needed, Mastodon API support. (compare: https://selfhost.directory/compare/snac-vs-soapbox)
- [Pleroma](https://selfhost.directory/project/pleroma): Pleroma is a lightweight fediverse server compatible with other Fediverse software such as Mastodon, Misskey, and Pixelfed. (compare: https://selfhost.directory/compare/pleroma-vs-soapbox)

## More in Social Networks & Forums

- [Socialhome](https://selfhost.directory/project/socialhome): Self-hosted federated social networking server using ActivityPub and Diaspora protocols for decentralized content sharing across the fediverse.
- [storyden](https://selfhost.directory/project/storyden): Self-hosted open-source forum and knowledge library for communities to own their conversations and data with optional AI features.
- [Streams](https://selfhost.directory/project/streams): Decentralised fediverse server with permission-based privacy controls. Compatible with Mastodon, Pleroma, Pixelfed, Friendica, Hubzilla ActivityPub federated services.
- [strfry](https://selfhost.directory/project/strfry): strfry is a self-hosted, open-source Nostr relay in C++ using LMDB with negentropy sync and Prometheus metrics.
- [Symphony](https://selfhost.directory/project/symphony): Self-hosted open-source Java community platform for forums, Q&A and social networking, with a big admin backend, themes and a Docker image.
- [Takahē](https://selfhost.directory/project/takahe): Self-hosted open-source ActivityPub server for microblogging with multi-domain and multi-identity support, Mastodon API compatible.
- [Talkyard](https://selfhost.directory/project/talkyard): Self-hosted open-source community platform combining forum, chat, Q&A, and blog comments — alternative to StackOverflow, Slack, Discourse, Reddit, Disqus.
- [teddit](https://selfhost.directory/project/teddit): Open-source, self-hosted Reddit front-end that strips JavaScript, ads and tracking, and serves an unofficial RSS and JSON API; no longer actively maintained.
- [ties](https://selfhost.directory/project/ties): ties is a self-hosted, open-source federated bookmark manager for organizing, sharing, and discovering web pages via ActivityPub federation.
- [tootik](https://selfhost.directory/project/tootik): tootik is a self-hosted, open-source federated social network with a Gemini protocol frontend, interoperating with Mastodon, Lemmy, and other ActivityPub platforms.
- [UBOS](https://selfhost.directory/project/ubos): UBOS 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.
- [valour](https://selfhost.directory/project/valour): Valour is a self-hosted, open-source Discord alternative offering end-to-end encrypted chat, voice, threads, wikis, and 2D villages with native apps.

## Links

- [Homepage](https://gitlab.com/soapbox-pub/soapbox-fe)
- [Demo](https://fe.soapbox.pub)
- [Soapbox FE documentation](https://docs.soapbox.pub/soapbox/)
- [Contributing translations](https://docs.soapbox.pub/soapbox/translations)

---
Source: https://selfhost.directory/project/soapbox