Warning

This documentation only applies for the development version of Funkwhale! Visit the docs for the latest release.

Uninstall Docker installation

To uninstall a Docker-based Funkwhale installation from your server, follow the instructions in this guide.

Warning

Removing Funkwhale data is irreversible. Make sure you back up your data.

Stop the Docker containers

Before you remove any data, you need to stop the Funkwhale containers.

  1. Navigate to your Funkwhale directory.

    cd /srv/funkwhale
    
  2. Stop the containers

    docker-compose down
    

Remove the reverse proxy

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

  1. 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
    
  2. Reload the web server.

    sudo systemctl reload nginx
    
  1. Remove the configuration files from your web host.

    sudo rm /etc/apache2/sites-enabled/funkwhale.conf
    sudo rm /etc/apache2/sites-available/funkwhale.conf
    
  2. Reload the web server.

    sudo service apache2 restart
    

Remove the containers and their volumes

Warning

This action is irreversible. Make sure you have backed up your data before proceeding.

Once you have stopped the containers, you can delete all containers and associated volumes.

docker-compose rm -fsv

Remove the Funkwhale directory

Once you have removed the containers and volumes, you can delete the Funkwhale directory.

sudo rm -rf /srv/funkwhale

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