aether-framework/docker

Datenbank per Docker

Startet eine MariaDB und spielt alle Schemas automatisch ein. Der FiveM- Server läuft dabei wie gewohnt auf dem Host und verbindet sich über 127.0.0.1:3306.

Start

cp .env.example .env          # Zugangsdaten anpassen (mind. Passwörter ändern)
docker compose up -d          # DB starten + migrieren
docker compose logs -f migrate

Beim ersten up wird die Datenbank angelegt und alle Schemas eingespielt. Bei jedem weiteren up prüft der Migrator die Tabelle schema_migrations und überspringt, was schon drin ist — mehrfaches Starten ist gefahrlos.

Verbindung im FiveM-Server

In server.cfg (Benutzer/Passwort/Port wie in der .env):

set mysql_connection_string "mysql://aether:aether@127.0.0.1:3306/aether?charset=utf8mb4"

Neue Migrationen hinzufügen

• Neues Modul-Schema: einfach eine .sql nach sql/ legen — der Migrator nimmt sie beim nächsten up automatisch mit (idempotent, also am besten mit CREATE TABLE IF NOT EXISTS).
• Nachtrag/Änderung an bestehenden Tabellen: als sql/updates/00X_….sql ablegen. Diese laufen fehlertolerant (ein „Duplicate column" auf einer frischen DB wird nur vermerkt, nicht als Fehler gewertet).

Reihenfolge: aether.sql zuerst, dann die übrigen Basis-Schemas, dann updates/*.sql.

Nützliche Befehle

docker compose --profile tools up -d      # zusätzlich Adminer auf :8080
docker compose exec db mariadb -uroot -p aether   # DB-Shell
docker compose down                        # stoppen (Daten bleiben)
docker compose down -v                     # stoppen + Daten löschen (frisch)

Nach down -v ist die DB leer — das nächste up migriert komplett neu.