Installation-(auf-uberspace).md

+# Oblobl Quickstart auf Uberspace
+
+## 1. Uberspace Account anlegen
+
+Registriere dich bei [Uberspace](https://uberspace.de) und erstelle einen Account.
+
+## 2. SSH-Verbindung herstellen
+
+Dafür brauchts im uberspace dashbord entweder deinen SSH-Key oder ein eingerichtetes Passwort. [Anleitung im Uberspace Manual](https://manual.uberspace.de/basics-ssh/)
+
+**$USER** – Platzhalter für den Uberspace-Benutzernamen, der durch den tatsächlichen Nutzernamen ersetzt werden sollte (manchmal muss).
+
+```sh
+ssh $USER@uber.space
+```
+
+## 3. Projektverzeichnis vorbereiten
+
+Navigiere zum Web-Root-Verzeichnis und lösche vorhandene Dateien:
+
+```sh
+cd /var/www/virtual/$USER/html
+rm *
+```
+
+## 4. Repository klonen
+
+Klonen des Projekts aus dem Git-Repository:
+
+```sh
+git clone https://git.caspari.cc/schni/oblobl.git .
+```
+
+## 5. MySQL-Zugangsdaten abrufen
+
+Führe den folgenden Befehl aus, um dein MySQL-Passwort zu erhalten, das Du gleich brauchst.
+
+```sh
+my_print_defaults client
+```
+
+## 6. Datenbank erstellen
+
+Erstelle die Datenbank mit folgendem Befehl:
+
+```sh
+mysql -e "CREATE DATABASE $datenbankname;"
+```
+**$datenbank** – Platzhalter für einen frei wählbaren Datenbanknamen, auf Uberspace muss davor Dein Benutzungsname und ein Unterstrich. Also  ` $user_irgendwas`.
+
+## 7. Konfigurationsdatei anpassen
+
+Öffne die Datei `config.php` zur Bearbeitung:
+
+```sh
+nano ~/html/inc/config.php
+```
+
+Ändere die folgenden Werte:
+- `<DB HOST>` → `127.0.0.1`
+- `database name` → `$USER_oblobldev`
+- `user` → `$USER`
+- `password` → Passwort aus `my_print_defaults client`
+
+**$USER** – Platzhalter für den Uberspace-Benutzernamen, der durch den tatsächlichen Nutzernamen ersetzt werden sollte.
+
+## 7a. PHP neu starten (vielleicht unnötig?)
+
+Starte den PHP-Dienst neu:
+
+```sh
+uberspace tools restart php
+```
+
+## 8. Datenbank-Initialisierung
+
+Bearbeite die Datei `mysql-init-db.sql`
+
+```sh
+nano ~/html/inc/mysql-init-db.sql
+```
+und setze den Namen Deiner Datenbank ein, den Du unter 6. gewählt hast.
+
+- `oblobdev` → `$datenbankname`.
+
+Führe das SQL-Skript aus:
+
+```sh
+mysql -p $datenbankname < mysql-init-db.sql
+```
+
+## 9. Ersten Benutzy anlegen
+
+Denke Dir einen Namen aus und erstelle ein temporäres Passwort und hashe es mit dem **CRYPT_BLOWFISH**-Algorithmus (`$2y$`-Format). Das geht z.B. mit dem [Bcrypt Generator](https://appdevtools.com/bcrypt-generator)
+
+Starte das MySQL-Terminal:
+
+```sh
+mysql -p $USER_$datenbankname
+```
+
+Melde dich mit dem zuvor erhaltenen MySQL-Passwort an (5.MySQL-Zugangsdaten )
+
+Setze das temporäre Passwort und Deinen Namen:
+
+```sql
+UPDATE Mensch SET passwort = 'das bcrypt_hash deines temporären Passworts', name = 'Dein Benutzyname' WHERE idMensch = 2;
+```
+
+## 10. Webanwendung aufrufen
+
+Öffne deine Uberspace-Domain:
+
+```
+https://$USER.uber.space
+```
+**$USER** – Platzhalter für den Uberspace-Benutzernamen, der durch den tatsächlichen Nutzernamen ersetzt werden muss.
+
+Logge dich mit deinem Namen und deem temporären Passwort ein und ändere es anschließend. (Vor allem, wenn Du ein Online-Tool verwendet hast um es zu hashen)
+
+Jetzt kannst Du weitere Benutzys hinzufügen.