soapbox/docs/administration/updating.md

1.6 KiB

Updating Soapbox

You should always check the release notes/changelog in case there are deprecations, special update changes, etc.

Besides that, it's relatively pretty easy to update Soapbox FE. There's two ways to go about it: with the command line or with an unofficial script.

Updating with the command line

To update Soapbox FE via the command line, do the following:

# Download the build.

curl -L https://gitlab.com/soapbox-pub/soapbox-fe/-/jobs/artifacts/v(latest.version.here)/download?job=build-production -o soapbox-fe.zip

# Remove all the current Soapbox FE build in Pleroma's instance directory.
sudo rm -R /opt/pleroma/instance/static/packs
sudo rm /opt/pleroma/instance/static/index.html
sudo rm -R /opt/pleroma/instance/static/sounds

# Unzip the new build to Pleroma's instance directory.
busybox unzip soapbox-fe.zip -o -d /opt/pleroma/instance

Updating with an unofficial script

You can also update Soapbox using Sandia Mesa's updater bash script for Soapbox FE.

First, download the updater script if you haven't yet: curl -O https://code.sandiamesa.com/traboone/soapbox-update/raw/branch/master/soapbox-update.sh

Then, set the permissions of the updater script so that it can be executed: chmod u+x soapbox-update.sh

Finally, run sudo ./soapbox-update.sh.

After updating Soapbox

The changes take effect immediately, just refresh your browser tab. It's not necessary to restart the Pleroma service.