Announcing Soapbox BE v1.0

Cover Image for Announcing Soapbox BE v1.0
Alex Gleason
Alex Gleason

Based on Pleroma

Soapbox BE is a production ready Pleroma branch based on Pleroma 2.3 stable. It's being maintained alongside Pleroma, with additional bugfixes and features. Our goal is to move faster, while taking deliberate care to ensure clean code merges between projects.

Soapbox BE contains code that has not yet been merged (or may never be merged) by Pleroma.

A new foundation

A big part of this release was just laying the groundwork to support another Fediverse backend: an updated website, an issue tracker, and proper documentation.

We are now free to do things that weren't possible before.

A full list of differences between Soapbox and Pleroma is documented here.

Soapbox FE by default

Soapbox FE

Soapbox FE is the default frontend of Soapbox BE. We think this is a good choice for growing the Fediverse, and it gives us more control over how the FE and BE interact.

It will still be possible to switch to another frontend as usual. See the FAQ below for details.

Rich media embeds

YouTube embed

Share a link to a popular video site, and users can watch right from their timeline! The following sites are tested to work:

  • YouTube
  • Vimeo
  • PeerTube instances
  • Giphy
  • Soundcloud (audio player)
  • Kickstarter
  • Flickr
  • anything on this list, and more

Most OEmbed compatible links will work. First we try known URL patterns, then fall back to scraping the page (discovery). Otherwise, it generates a link preview as usual.

Rich media embeds are sanitized and can only contain an iframe or image. Unsafe embeds fall back to link previews.

Configurable block behavior

On Twitter, blocking someone prevents them from seeing your posts. On the Fediverse, it's a mixed bag. Different servers handle blocks differently.

We think it makes sense for the default behavior to be Twitter-like, as it's what users expect. You can now configure it in Admin FE, under "ActivityPub > Blockers visible"

Note: This setting cannot force a remote server to change their behavior, it only changes the behavior of your server.

Bug fixes

  • Domain blocks: reposts from a blocked domain are now correctly blocked. (!11)
  • Fixed some (not all) Markdown issues, such as broken trailing slash in links. (!10)
  • Don't crash so hard when email settings are invalid. (!12)
  • Return OpenGraph metadata on Soapbox FE routes. (!14)

Installing Soapbox

To install a fresh server, see our install guide.

Switching from Pleroma

Switching over is easy. As long as you're on Pleroma 2.3, you can simply checkout the repo:

sudo -Hu pleroma bash
cd /opt/pleroma

git remote add soapbox
git fetch soapbox --tags
git checkout -b soapbox soapbox-v1.0.0

MIX_ENV=prod mix deps.get
MIX_ENV=prod mix compile

# As root
systemctl restart pleroma

Note: Only the source version of Pleroma is supported. If you're using the OTP release, you may need to switch to the source version first.


  • Will Soapbox FE continue to support vanilla Pleroma? — Yes. Soapbox FE already uses version detection for compatibility across versions. It will continue to support Pleroma.

  • Will Soapbox BE stay updated with Pleroma? — Yes. New stable releases of Pleroma will be merged into Soapbox BE. Soapbox BE releases will happen after Pleroma releases. Think of the relationship between Ubuntu and Debian.

  • Can I switch back to Pleroma? — Yep, you can safely switch between Soapbox BE 1.0 and Pleroma 2.3. This release does not modify the database at all. Future releases will modify the database in reversible, non-destructive ways.

  • Can I use Pleroma FE with Soapbox BE? — Technically, yes. You can remove Soapbox FE as the "primary" frontend within AdminFE, and it will fall back to Pleroma FE. This use case is unsupported by Pleroma FE devs, but it seems to work fine.

  • Can I use a customized frontend/custom build? — Yep. Anything you put in /opt/pleroma/instance will override the default frontend. If you put a custom build here, remember to upgrade the FE and BE separately.

Fund the Soapbox Project

Soapbox is funded entirely by donations. If you would like to support me, you can send me a donation. Your support is greatly appreciated, and every bit counts.

  • Credit Card — PayPal (
  • Bitcoin — bc1q9cx35adpm73aq2fw40ye6ts8hfxqzjr5unwg0n
  • Etherium — 0xAc9aB5Fc04Dc1cB1789Af75b523Bd23C70B2D717
  • Dogecoin — D5zVZs6jrRakaPVGiErkQiHt9sayzm6V5D
  • Ubiq (10grans) — 0x541a45cb212b57f41393427fb15335fc89c35851
  • Monero — 45JDCLrjJ4bgVUSbbs2yjy9m5Mf4VLPW8fG7jw9sq5u69rXZZopQogZNeyYkMBnXpkaip4p4QwaaJNhdTotPa9g44DBCzdK

Thank you!

A huge thank you to everyone who has been so supportive of my efforts, from the donations to the moral support to development help. Thank you to the Pleroma dev team for building a great foundation. I really appreciate you all being a part of this and look forward to advancing the Fediverse together.

Last edited .

Like what we do?

Soapbox is open source software, and we rely on generous donations from community members like you. ❤️