Direkt zum Hauptinhalt

Backup and Restore

Beschreibung:

Bookstack besteht aus Dateien und Der Datenbank

Hier liegen die Dateien bzw Verzeichnisse

  • .env - File, contains important configuration information.
  • public/uploads - Folder, contains any uploaded images.
  • storage/uploads - Folder, contains uploaded page attachments.
  • themes - Folder, contains any configured visual/logical themes.

Backup:

Die Dateien sichern.

In das Verzeichnis gehen bei ner direkt installation:

cd /var/www/Bookstack

Bei ner docker installtion reicht das ganze Projektverzeichnis, das der Vorteil von der Docker.
nun ein archiv erstellen

tar -czvf bookstack-files-backup-$(date +"%Y-%m-%d_%H-%M-%S").tar.gz .env public/uploads storage/uploads themes

Nun die Datenbank sichern

mysqldump -u root bookstackdb > bookstack.backup-$(date +"%Y-%m-%d_%H-%M-%S").sql

Diese beiden Datein ins root Verzeichnsi vom neuen Server kopieren via scp zum Beispiel

Restore/Migration

Migration:

Manuell:

Im Docker container, weil direkt installation machen wir in Zukunft nicht mehr:
Falls der Conatiner schon unglücklicherweise gestartet wurde den container app stoppen

docker-compose app down

Das Datenverzeichnis löschen

rm -r /root/bookstack/bookstack_data

Nun die Datenbank restoren.restoren via phpmyadmin

Nun den app key aus der alten instance in die .env Datei eintragen.
in einer nicht Docker installation leigt diese dann unter

cat /var/www/Boockstack/.env

Ein bisschen hochscrollen da steht der APP_KEY diesen kopieren und in die neue .env einfügen / ersetzten

 

 

Nachbearbeitung bei Manuel wie auch mit Backup Tool:

Sollte nicht auf die gleiche Version migriert werden nachdem der Container gestartet ist, die migration ausführen das die Datenbank angepasst wird.

Dzu einmal in den container einloggen

docker-compose exec app bash

Dann diese Befehler ausfürhen

cd /app/www
php artisan migrate

Ausgabe:

php artisan migrate

                                                                                                                                                                                                                                               
                                                                                                          APPLICATION IN PRODUCTION.                                                                                                           
                                                                                                                                                                                                                                               

 ┌ Are you sure you want to run this command? ──────────────────┐
 │ ● Yes / ○ No                                                 │
 └──────────────────────────────────────────────────────────────┘
bestätigen