# Bookstack 還原紀錄

## 參考資料

[Bookstack Admin Documentaion - Backup and Restore](https://www.bookstackapp.com/docs/admin/backup-restore/)

## 備份

匯出資料庫內容

mysqldump --no-tablespaces -u bookstack -p bookstack > bookstack-backup.sql

註：Mysql 8.0 以上的版本需要加上 `--no-tablespaces` 語法，不然會報錯

mysqldump: Error: 'Access denied; you need (at least one of) the PROCESS privilege(s) for this operation' when trying to dump tablespaces

壓縮打包須備份的檔案：

- `.env`
- `public/uploads`
- `storage/uploads`

## 還原

1. 直接安裝新版本 Bookstack

註：如果是使用 Script 安裝，請先註解掉 `php artisan migrate` 這行命令再執行安裝

2. 還原倒入資料庫

mysql -u bookstack -p bookstack < bookstack-backup.sql

註：密碼是安裝的新資料庫密碼，非原本的資料庫密碼

3. 將打包的壓縮檔解壓縮，放到正確的位置並確定相關權限、使用者、群組的正確性

註：`.env` 的資料庫密碼須改為新的

4. 執行 `php artisan migrate`

###### tags: `bookstack`