Installation
Voraussetzungen
Docker und Docker Compose müssen installiert sein.
Per Script (empfohlen)
Das Installations-Skript richtet die Docker Container und das Management Programm mizdb ein. Außerdem fragt es bei der
Installation, ob die Datenbank aus einem Backup wiederhergestellt werden soll.
bash -c "$(curl -sSL https://raw.githubusercontent.com/Actionb/MIZDB/master/scripts/install-mizdb.sh)"
Nach dem Ausführen des Skripts sollte MIZDB unter http://localhost/miz/ verfügbar sein.
Per Docker Compose
Die Dateien docker-compose.yaml und docker-compose.env (hier
auf github) in einen Ordner deiner Wahl herunterladen, z.B.:
curl -fsSL "https://raw.githubusercontent.com/Actionb/MIZDB/master/docker/docker-compose.yaml" -o docker-compose.yaml
curl -fsSL "https://raw.githubusercontent.com/Actionb/MIZDB/master/docker/docker-compose.env" -o docker-compose.env
Anschließend führe folgenden Befehl aus, um die Docker Container zu erzeugen und zu starten:
Als Nächstes muss noch die Datenbank eingerichtet werden. Dazu kann entweder ein vorhandenes Backup eingelesen werden oder komplett neue Datenbanktabellen erzeugt werden.
Backup wiederherstellen
Mit dem folgenden Befehl kann ein Backup der Datenbank mit dem Dateinamen backup eingelesen werden:
docker exec -i mizdb-postgres /bin/sh -c 'export PGUSER="$POSTGRES_USER" && export PGHOST=localhost && dropdb "$POSTGRES_DB" && createdb "$POSTGRES_DB" && pg_restore --dbname "$POSTGRES_DB"' < backup
Neue Datenbanktabellen erzeugen
Soll kein Backup wiederhergestellt werden, müssen die Datenbanktabellen erzeugt werden:
Management Werkzeug herunterladen
mizdb.sh herunterladen, um die Verwaltung leichter zu gestalten:
Um mizdb.sh überall als mizdb ausführbar zu machen:
cat << EOF > ~/.local/bin/mizdb
#!/bin/sh
file=\$(readlink -f "\$2")
cd $(pwd) || exit
bash mizdb.sh "\$1" "\$file"
cd - > /dev/null || exit
EOF
chmod +x ~/.local/bin/mizdb
MIZDB konfigurieren
Einstellungen wie Datenbankpasswort und E-Mail Settings können mit der Datei docker-compose.env geändert
werden. Standardmäßig liegt diese Datei in dem Ordner ~/.local/share/MIZDB (genauer: $XDG_DATA_HOME/MIZDB). Der
Befehl mizdb config kann verwendet werden, um diese Datei zu finden:
Docker Compose Eigenschaften wie zum Beispiel Volumes und Mounts können in der Datei docker-compose.yaml geändert werden, die in demselben Ordner wie docker-compose.env zu finden ist.
Siehe dazu Die Docker Compose Referenz: Compose File Reference