95 lines
2.0 KiB
Markdown
95 lines
2.0 KiB
Markdown
# 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](../upgrade/backup.md).
|
|
```
|
|
|
|
```{contents}
|
|
:local:
|
|
:depth: 1
|
|
```
|
|
|
|
## Stop the Docker containers
|
|
|
|
Before you remove any data, you need to stop the Funkwhale containers.
|
|
|
|
1. Navigate to your Funkwhale directory.
|
|
|
|
```{code-block} sh
|
|
cd /srv/funkwhale
|
|
```
|
|
|
|
2. Stop the containers
|
|
|
|
```{code-block} sh
|
|
sudo docker compose down
|
|
```
|
|
|
|
## 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
|
|
|
|
1. Remove the configuration files from your web host.
|
|
|
|
```{code-block} sh
|
|
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.
|
|
|
|
```{code-block} sh
|
|
sudo systemctl reload nginx
|
|
```
|
|
|
|
:::
|
|
|
|
:::{tab-item} Apache2
|
|
:sync: apache2
|
|
|
|
1. Remove the configuration files from your web host.
|
|
|
|
```{code-block} sh
|
|
sudo rm /etc/apache2/sites-enabled/funkwhale.conf
|
|
sudo rm /etc/apache2/sites-available/funkwhale.conf
|
|
```
|
|
|
|
2. Reload the web server.
|
|
|
|
```{code-block} sh
|
|
sudo service apache2 restart
|
|
```
|
|
|
|
:::
|
|
::::
|
|
|
|
## Remove the containers and their volumes
|
|
|
|
```{warning}
|
|
This action is __irreversible__. Make sure you have [backed up your data](../upgrade/backup.md) before proceeding.
|
|
```
|
|
|
|
Once you have stopped the containers, you can delete all containers and associated volumes.
|
|
|
|
```{code-block} sh
|
|
sudo docker compose rm -fsv
|
|
```
|
|
|
|
## Remove the Funkwhale directory
|
|
|
|
Once you have removed the containers and volumes, you can delete the Funkwhale directory.
|
|
|
|
```{code-block} sh
|
|
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.
|