Hướng dẫn cài đặt BookStack trên cPanel

Giới Thiệu

BookStack là một hệ thống quản lý kiến thức mã nguồn mở được thiết kế để hỗ trợ việc tạo, tổ chức, và chia sẻ thông tin và tài liệu. Được phát triển bởi Dan Brown và cộng đồng người dùng, BookStack cung cấp một nền tảng linh hoạt và dễ sử dụng cho việc xây dựng và duyệt qua các tập hồi báo, tài liệu kỹ thuật, và nguồn kiến thức khác.

Đặc Điểm Nổi Bật:

• Giao Diện Người Dùng Thân Thiện : BookStack có một giao diện người dùng thân thiện và dễ sử dụng, giúp người dùng tập trung vào việc tạo và tổ chức nội dung một cách dễ dàng.
• Tổ Chức Hiệu Quả : Hệ thống sử dụng khái niệm về “Kho” (Space) để tập hợp các chủ đề hoặc dự án. Bên trong mỗi Kho, người dùng có thể tạo ra các “Sách” (Books) để tổ chức thông tin và tài liệu.
• Quản Lý Người Dùng và Quyền Truy Cập : Hỗ trợ quản lý người dùng và quyền truy cập, giúp kiểm soát ai có thể xem, chỉnh sửa, hoặc thậm chí quản lý nội dung.
• Phiên Bản Hóa và Lịch Sử Sửa Đổi : Hệ thống tự động theo dõi lịch sử sửa đổi và cung cấp khả năng quay lại phiên bản trước đó của một trang.
• Hỗ Trợ Đa Ngôn Ngữ : BookStack hỗ trợ nhiều ngôn ngữ, giúp mở rộng sự tiện lợi và sử dụng cho người dùng trên khắp thế giới.
• Tích Hợp Tìm Kiếm Hiệu Quả : Tích hợp tính năng tìm kiếm mạnh mẽ để giúp người dùng dễ dàng tìm kiếm thông tin trong hệ thống.
• Mã Nguồn Mở và Tích Hợp Linh Hoạt : Là một dự án mã nguồn mở, BookStack cho phép cộng đồng người phát triển đóng góp và tùy chỉnh theo nhu cầu cụ thể của họ.

Các bước cài đặt

Bước 1 : Đăng nhập vào cPanel

Đầu tiên, đăng nhập vào tài khoản cPanel của bạn. Sử dụng thông tin đăng nhập được cung cấp bởi nhà cung cấp dịch vụ hosting.

Bước 2: Tạo Cơ sở Dữ liệu MySQL

Mở mục “MySQL® Database Wizard” trong cPanel

Điền tên database sau đó bấm Next Step

Điền tên database user và password sau đó bấm Create User

Bước cuối tích vào ALL PRIVILEGES để cho phép toàn quyền user vào database , sau đó bấm Next Step là hoàn tất viêc tạo cơ sở dữ liệu

Bước 3: Tải và cài đặt BookStack

Truy cập trang chính thức của BookStack để tải về phiên bản mới nhất: https://www.bookstackapp.com

Mọi người có thể mở link Github để tải về máy cá nhân rồi upload lên hosting , ở đây thì mình tải trực tiếp về hosting bằng lệnh ở trong phần Terminal của hosting luôn nhé :

Di chuyển vào thư mục cần cài ,và tải xuống mã nguồn của BookStack từ kho lưu trữ GitHub bằng lệnh sau:

cd bookstack.quyenlt.com
git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch bookstack

Tiếp theo, cài đặt các gói phụ thuộc của BookStack bằng lệnh Composer:

cd bookstack
composer install

Chỉnh sửa tệp .env để cấu hình kết nối cơ sở dữ liệu mà đã tạo ở bước 2 nhé . Chạy lệnh sau để tạo tệp .env:

cp .env.example .env
vi .env

Sau khi chỉnh sửa xong, lưu lại và chạy các lệnh sau để hoàn thiện quá trình cài đặt:

php artisan key:generate

Chạy lệnh sau để kết nối với database trong file .env đã config :

php artisan migrate --force

Tới đây mọi người mở File Manager ở hosting và di chuyển toàn bộ thư mục bên trong bookstack ra ngoài Doucument Root của domain :

Tiếp theo tạo 1 file .htaccess và thêm đoạn cấu hình sau để website đọc thư mục public của mã nguồn trước nhé

<IfModule mod_rewrite.c>
Options +FollowSymLinks
RewriteEngine On
RewriteCond %{REQUEST_URI} !^/public/
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /public/$1 
#RewriteRule ^ index.php [L]
RewriteRule ^(/)?$ public/index.php [L] 
</IfModule>

Bước 4 : Kiểm tra kết quả

Nào chúng ta cùng mở trình duyệt lên và gõ http://IP hoặc http://domain.com và tận hưởng thành quả nhé các bạn. Chúng ta chỉ cần truy cập bằng tài khoản mặc định là được rồi nhé

User: admin@admin.com và Pass: password

Kết luận

Trên đây là hướng dẫn cài đặt BookStack trên CPanel. Sau khi hoàn tất quá trình cài đặt, bạn có thể truy cập vào BookStack thông qua trình duyệt web và bắt đầu xây dựng và quản lý các tài liệu của mình một cách dễ dàng. Hy vọng rằng bài viết này đã giúp bạn hiểu rõ về quy trình cài đặt BookStack và sẽ mang lại lợi ích cho công việc của bạn.Chúc các bạn cài đặt thành công và có thể bắt đầu sử dụng nó để quản lý kiến thức và tài liệu của mình một cách hiệu quả.