---
# System prepended metadata

title: Bookstack 還原紀錄
tags: [bookstack]

---

# 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`