Soapbox FE v1.1 Released

Soapbox Frontend is a user interface for the Pleroma social media server. Today we're celebrating a major Quality of Life upgrade! ๐ŸŽ‰

Mon, Oct 5, 2020

What is Pleroma?

Pleroma is a free and open source, federated, social media software allowing anyone to host their own online community. Servers can cross-communicate with other servers on the network thanks to federation. Soapbox FE is a sleek user interface that server admins can install on top of Pleroma.

Quality of Life

This release is so solid it makes v1.0 feel unfinished. Truly, Soapbox FE was put to the ultimate test — a real social network with 14,000 users.

185 issues were closed. Major new features were added. This update brings us up to speed with the latest Pleroma, released last month.

The Big Migration

Spinster, the largest feminist server on the network, has now been migrated from Mastodon to Pleroma. This was a difficult challenge that pushed us to the limit.

Fortunately, our theory was correct, and Spinster now requires a fraction of the resources to operate. Before and after:

Having a real userbase this time made all the difference. Users quickly identified bugs, and motivated us to make the software more robust to accomodate such a large community.

Spinster is not the only site migrated to Pleroma+Soapbox this round. Community member Anirudh Oppiliappan was the first outsider to successfully migrate Mastodon to Pleroma using our tool, and his blog post hit the front page of Hacker News. Congrats Anirudh!


Without a doubt, Pleroma's biggest new feature is federated chats. Chats are private and 1-on-1. This exciting new way to communicate is only available on some backends, so you'll want your friends to be on Pleroma too.

"Mobile First" is the norm nowadays, but I think the Fediverse really needs a Facebook-style chat interface. So I built both. On desktop you can chat while browsing, and on mobile the chat will fill the screen.

Soapbox Config

A big promise of Soapbox has always been server customization. As an admin, you're expected to bring your own brand. In older versions of Soapbox this required manually editing a file on the server, but now site settings such as logo and brand color can be customized right through the GUI.

Upgrade note: If you've already configured a soapbox.json file, simply load the config page once and hit "Save". This will move your soapbox.json into the database, and you can safely delete it from your server.

Profile Hover Cards

A classic Twitter feature, it took far too long for this to hit the Fediverse. Just hover your mouse over a user to see a preview of their account.

Theme Toggle

To protect your eyes, you can now quickly switch themes. In direct sunlight you'll likely need light mode to see the screen at all. While browsing at night, dark mode is easier on the eyes.


Posts are now Markdown-enabled by default! This will enable rich text formatting, and can be easily disabled on a per-post basis.

Instance Favicons

In order to help newcomers understand the Fediverse, instance favicons can be shown next to each post. This feature needs to be enabled in Pleroma settings before it will take effect.

This is the first step in an initiative to "gameify" the Fediverse, and make its unique qualities truly shine.

Import Data

Probably the most highly requested feature since the v1.0 release, users want to import their follows when moving from Mastodon to a Pleroma+Soapbox server. CSV exports from Mastodon can now be imported into Soapbox FE.


To easily revisit posts later, they can be bookmarked and revisited any time.

Audio Player

Uploading sound clips displays an embedded audio player. Uploading multiple files will display the audio player in a modal window.

Timeline Filters

More advanced timeline filtering options now exist, such as filtering out DMs.

Word Filters

Certain words or phrases can be filtered out of your timeline.

Multi-Factor Auth

For improved security, users can enable multi-factor auth. After setup, this will prompt them to enter a time-based code from an OTP app on their phone whenever they log in.

Layout Improvements

Space was optimized in this release so all three columns are used.

Recurring Donations (Experimental)

You may have noticed the "Donation" widget in these screenshots. That comes from Patron, an experimental recurring donations platform. It's already running in production on a few servers, but isn't ready for broader adoption yet.

Our end goal for this is to allow servers to be self-funded by their users.

Bug Fixes

Some pretty annoying bugs were fixed. In particular there were some deep issues with scrollable lists and the post composer that got resolved.

View the CHANGELOG for the complete list of bug fixes.

Happy Halloween!

One of the few missing features from Soapbox Legacy has returned in this release, just in time for Halloween. ๐ŸŽƒ Enable it in your Preferences.

In the Future

Just a small preview of a few ideas we're working on for a later release:

Have an idea? Submit it to our issue tracker.

Installing Soapbox FE

Installation on an existing Pleroma server is a breeze, and can be done in less than 5 minutes. It is easy to remove if you change your mind.

To upgrade, repeat these steps.

0. Install Pleroma

If you haven't already, follow this guide to install Pleroma. If you're still running an old Pleroma version, be sure to upgrade it before upgrading Soapbox FE.

1. Fetch the v1.1 build

curl -L -o

2. Unpack

busybox unzip -o -d /opt/pleroma/instance

Or, if you installed the OTP release, unpack to this path instead:

busybox unzip -o -d /var/lib/pleroma

That's it! 🎉 Soapbox FE is installed. The change will take effect immediately, just refresh your browser tab. It's not necessary to restart the Pleroma service.

Note that it replaces Pleroma FE. (Running alongside Pleroma FE is also possible). Logged-in users will have to re-authenticate.

For removal, run: rm /opt/pleroma/instance/static/index.html

3. Customize it

After logging in, click your avatar in the topbar, and navigate to Soapbox Config to customize it. Additional settings can be found under Admin Settings in the same menu.

Fund the Soapbox Project

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


A HUGE thank you to everyone who helped make this release a reality! In particular I'd like to thank M.K. Fain and the Spinster community for pushing to make this release perfect. And of course, the usual suspects. ๐Ÿ˜‰

To everyone else I did not mention, a huge thank you for being part of this journey! I'm eternally grateful, and excited about how this community is growing.

Stay Updated

To keep updated, follow me on the Fediverse at Thanks for your support!