Hướng dẫn cập nhật phiên bản BookStack thủ công - Online

Ở trường hợp này, chúng ta sẽ cập nhật thủ công theo kiểu "Ghi đè" (Overwrite), trên máy chủ có truy cập Internet. Quy trình sẽ là:

• Tải code mới về
• Giải nén
• Ghi đè lên code cũ
• Chạy lệnh cập nhật.

Bước 1: Sao lưu file cấu hình (Cực kỳ quan trọng)

Vì chúng ta sắp ghi đè file, đầu tiên chúng ta cần backup file .env (chứa password database, key mã hóa). Nếu mất file này là mất dữ liệu.

# Di chuyển vào thư mục chứa mã nguồn và thực hiện lệnh sao lưu file .env
cp .env .env.backup_2026

Bước 2: Tải và giải nén mã nguồn mới

Chạy lần lượt các lệnh sau để tải bản Release mới nhất từ GitHub:

# Tải file nén về - Yêu cầu kết nối Internet
wget https://github.com/BookStackApp/BookStack/archive/release.zip

# Giải nén (nó sẽ tạo ra một thư mục tên là BookStack-release)
unzip release.zip

Bước 3: Ghi đè mã nguồn mới

Bây giờ chúng ta copy toàn bộ nội dung trong thư mục vừa giải nén đè lên thư mục hiện tại.

Lưu ý: Lệnh cp này sẽ ghi đè các file hệ thống nhưng không làm mất thư mục storage hay public/uploads của website, nên dữ liệu ảnh vẫn an toàn.

# Copy đè file mới vào thư mục hiện tại
cp -r BookStack-release/* .

# Dọn dẹp thư mục rác và file zip đã tải về trước đó
rm -rf BookStack-release release.zip

Bước 4: Chạy các lệnh cập nhật hệ thốngSau khi code đã mới, chúng ta cần cập nhật thư viện và database.

# 1. Cập nhật thư viện Composer - Yêu cầu máy chủ kết nối Internet
composer install --no-dev

# 2. Cập nhật Database (Schema) - Nhập "Yes" khi được hỏi
php artisan migrate

# 3. Xóa Cache để nhận diện giao diện mới
php artisan cache:clear
php artisan view:clear
php artisan config:clear

Bước 5: Kiểm tra lại phiên bản

# Kiểm tra lại phiên bản
cat version