Soapbox FE v1.2 Released

Soapbox Frontend is a user interface for the Pleroma social media server. Today we're celebrating a major feature release! 🎉

Fri, Apr 2, 2021

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.

Battle Tested

With a slew of administration new features, this release builds on the stability of the v1.1 release. It brings us up to speed with Pleroma 2.3, released last month.

Admin Dashboard

Managing a Fediverse server can be challenging. That's why we brought the most important admin features into a convenient dashboard.

Reports can now be handled directly within Soapbox! Admins will get notified of reports. Take actions on reports, or close many reports quickly.

A quick registration switcher lets you close signups at your convenience. This is a useful for fighting spam or brigades.

The "Approval Required" option is better than ever. When enabled, you'll get a notification for new signups, which you can approve through the dashboard. I highly recommend this option for most communities.

Need to figure out what happened? Review the mod log to see a history of events.

Inline Moderation

Admins can take actions on users directly from their profile or in timelines. When deleting a local user, you must tick the box to prevent mistakes.

Remote Timelines

It's easy to see what's going on in remote servers. Click the favicon by any post and you will see the timeline for that instance. This promotes discoverability of federation, and helps people learn more about different communities on the Fediverse.

Note: you must enable instance favicons in AdminFE for this to take effect.

Multiple Account Support

To promote a project, idea, or brand, it is common to create a separate account. Now it is easy to switch between them. Simply sign in to each account, and they will all appear in your menu. Only local accounts are supported.

In supported browsers, you can middle-click an account to activate it in a new tab.

Remote Follow Button

To increase compatibility with third-party Fediverse software, remote follow is now possible.

Responsive Follows

The follow button updates immediately when it goes through. Previously, you had to refresh the page.

Registration Feedback

To date, "I can't log in" is still the number one complaint of Fediverse users. It is usually user error. We've done everything we can to streamline this process to make it easier to understand what's going on.

Import Mutes

Importing mutes by CSV is now possible.

Bug Fixes

View the CHANGELOG for the complete list of bug fixes.

Verifications (Blue Check)

For no other reason than just for fun, admins can give users a blue checkmark. This feature does not federate, but larger servers might find it useful.

In the Future

Here are some things we hope to include in the next version:

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, you should upgrade it.

1. Fetch the v1.2 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).

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

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. Thank you!

Update: 1.2.1 (Apr 6, 2021)

A new minor release fixes the following bugs:

Update: 1.2.2 (Apr 13, 2021)

A new minor release fixes the following bugs:

Update: 1.2.3 (Apr 18, 2021)

A new minor release makes the following changes:


A HUGE thank you to everyone who helped make this release a reality!

To everyone else I did not mention, a huge thank you for being part of this journey!

Stay Updated

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