Huge role refactoring/cleanup. Other commits will propably follow. Because some bugs will exist. Still important for longrun and also for auto docs/help/slideshow generation

roles/web-app-friendica/Administration.md

@@ -0,0 +1,98 @@
+# Administration
+
+## CLI
+The CLI you reach via
+```bash
+docker compose exec --user www-data application bin/console
+```
+
+## Full Reset 🚫➡️✅
+
+The following environment variables need to be defined for successful operation:
+
+- `DB_ROOT_PASSWORD`: The root password for the MariaDB instance
+
+To completely reset Friendica, including its database and volumes, run:
+```bash
+docker exec -i {{applications.mariadb.hostname }} mariadb -u root -p"${DB_ROOT_PASSWORD}" -e "DROP DATABASE IF EXISTS friendica; CREATE DATABASE friendica;"
+docker compose down
+rm -rv /mnt/hdd/data/docker/volumes/friendica_data
+docker volume rm friendica_data
+```
+
+## Reset Database 🗄️
+
+## Manual Method:
+1. Connect to the MariaDB instance:
+   ```bash
+   docker exec -it {{applications.mariadb.hostname }} mariadb -u root -p
+   ```
+2. Run the following commands:
+   ```sql
+   DROP DATABASE friendica;
+   CREATE DATABASE friendica;
+   exit;
+   ```
+
+## Automatic Method:
+```bash
+DB_ROOT_PASSWORD="your_root_password"
+docker exec -i {{applications.mariadb.hostname }} mariadb -u root -p"${DB_ROOT_PASSWORD}" -e "DROP DATABASE IF EXISTS friendica; CREATE DATABASE friendica;"
+```
+
+## Enter the Application Container 🔍
+
+To access the application container:
+```bash
+docker compose exec -it application sh
+```
+
+## Debugging Tools 🛠️
+
+## Check Environment Variables
+```bash
+docker compose exec -it application printenv
+```
+
+## Inspect Volume Data
+```bash
+ls -la /var/lib/docker/volumes/friendica_data/_data/
+```
+
+## Autoinstall 🌟
+
+Run the following command to autoinstall Friendica:
+```bash
+docker compose exec --user www-data -it application bin/console autoinstall
+```
+
+## Reinitialization 🔄
+
+## Docker Only:
+```bash
+docker-compose up -d --force-recreate
+```
+
+## Full Reinitialization:
+```bash
+docker-compose up -d --force-recreate && sleep 2; docker compose exec --user www-data -it application bin/console autoinstall;
+```
+
+## Configuration Information ℹ️
+
+## General Configuration:
+```bash
+cat /var/lib/docker/volumes/friendica_data/_data/config/local.config.php
+```
+
+## Email Configuration:
+```bash
+docker compose exec -it application cat /etc/msmtprc
+```
+
+## Email Debugging ✉️
+
+To send a test email:
+```bash
+docker compose exec -it application msmtp --account=system_email -t test@test.de
+```