3.5 KiB

Raw Blame History

Uninstall Debian installation

To uninstall Funkwhale from your Debian server, follow the instructions in this guide.

Removing Funkwhale data is __irreversible__. Make sure you [back up your data](../upgrade/backup.md).

:local:
:depth: 1

Stop the Funkwhale server

Before you uninstall anything from your server, you need to stop the Funkwhale systemd services.

Stop all systemd services listed under the funkwhale target
```
sudo systemctl stop funkwhale.target
```

Disable all systemd services to prevent launch at startup.

sudo systemctl disable funkwhale-server
sudo systemctl disable funkwhale-worker
sudo systemctl disable funkwhale-beat

Remove the service files.

sudo rm /etc/systemd/system/funkwhale-server.service
sudo rm /etc/systemd/system/funkwhale-worker.service
sudo rm /etc/systemd/system/funkwhale-beat.service
sudo rm /etc/systemd/system/funkwhale.target

Reload all services to pick up the changes.

sudo systemctl daemon-reload
sudo systemctl reset-failed

Remove the reverse proxy

To stop serving Funkwhale from your web server, you need to remove your reverse proxy configuration.

::::{tab-set}

:::{tab-item} Nginx :sync: nginx

Remove the configuration files from your web host.

sudo rm /etc/nginx/sites-enabled/funkwhale.conf
sudo rm /etc/nginx/sites-available/funkwhale.conf
sudo rm /etc/nginx/funkwhale_proxy.conf

Reload the web server.
```
sudo systemctl reload nginx
```

:::

:::{tab-item} Apache2 :sync: apache2

Remove the configuration files from your web host.

sudo rm /etc/apache2/sites-enabled/funkwhale.conf
sudo rm /etc/apache2/sites-available/funkwhale.conf

Reload the web server.
```
sudo service apache2 restart
```

::: ::::

Remove the Funkwhale database

This action is __irreversible__. Make sure you have [backed up your data](../upgrade/backup.md) before proceeding.

Once you have stopped the Funkwhale services, you can remove the Funkwhale database.

Navigate to your Funkwhale directory.
```
cd /srv/funkwhale
```

Delete the Funkwhale database.

sudo -u postgres psql -c 'DROP DATABASE funkwhale;'

Delete the Funkwhale user.

sudo -u postgres psql -c 'DROP USER funkwhale;'

Delete the Funkwhale account

This action deletes the `/srv/funkwhale/` directory. Make sure you have [backed up any data](../upgrade/backup.md) you want to keep.

Once you have removed the database, you can delete the funkwhale user and all associated data.

sudo userdel -r funkwhale

This deletes the funkwhale user and everything in their home directory (/srv/funkwhale/). If your content is hosted in an S3-compatible store, you need to delete this data separately.

Uninstall dependencies

Funkwhale uses the following dependencies on your server:

::::{tab-set}

:::{tab-item} Apt :sync: apt


build-essential
curl
ffmpeg
libjpeg-dev
libmagic-dev
libpq-dev
postgresql-client
python3-dev
libldap2-dev
libsasl2-dev
make

:::

:::{tab-item} Python :sync: python

:language: toml
:lines: 9-59