mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2025-10-30 23:07:57 +01:00
4e44c4885e
This commit adds copyright headers to the same kind of docs as ones linked from e48af8a327/docs/README.md, so that these files can be reused over there.
- docs/README.md
- prerequisites.md
- configuring-dns.md
- getting-the-playbook.md
- configuring-playbook.md
- maintenance-upgrading-services.md
- maintenance-and-troubleshooting.md
- uninstalling.md
Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
<!--
|
|
SPDX-FileCopyrightText: 2018 - 2022 Slavi Pantaleev
|
|
SPDX-FileCopyrightText: 2018 MDAD project contributors
|
|
SPDX-FileCopyrightText: 2024 - 2025 Suguru Hirahara
|
|
|
|
SPDX-License-Identifier: AGPL-3.0-or-later
|
|
-->
|
|
|
|
# Uninstalling
|
|
|
|
> [!WARNING]
|
|
> - If your server federates with others, make sure to **leave any federated rooms before nuking your Matrix server's data**. Otherwise, the next time you set up a Matrix server for this domain (regardless of the installation method you use), you'll encounter trouble federating.
|
|
> - If you have some trouble with your installation, you can just [re-run the playbook](installing.md) and it will try to set things up again. **Uninstalling and then installing anew rarely solves anything**.
|
|
|
|
## Uninstalling using a script
|
|
|
|
Installing places a `/matrix/bin/remove-all` script on the server.
|
|
|
|
You can run it to to have it uninstall things for you automatically (see below). **Use with caution!**
|
|
|
|
## Uninstalling manually
|
|
|
|
If you prefer to uninstall manually, run these commands (most are meant to be executed on the Matrix server itself):
|
|
|
|
- ensure all Matrix services are stopped: `ansible-playbook -i inventory/hosts setup.yml --tags=stop` (if you can't get Ansible working to run this command, you can run `systemctl stop 'matrix*'` manually on the server)
|
|
|
|
- delete the Matrix-related systemd `.service` and `.timer` files (`rm -f /etc/systemd/system/matrix*.{service,timer}`) and reload systemd (`systemctl daemon-reload`)
|
|
|
|
- delete some cached Docker images (`docker system prune -a`) or just delete them all (`docker rmi $(docker images -aq)`)
|
|
|
|
- delete the Docker networks: `docker network rm matrix matrix-coturn` (might have been deleted already if you ran the `docker system prune` command)
|
|
|
|
- uninstall Docker itself, if necessary
|
|
|
|
- delete the `/matrix` directory (`rm -rf /matrix`)
|