Cara Self-Host BookStack di VPS (Panduan Lengkap)

BookStack adalah platform sederhana yang di-host sendiri untuk mengatur dan menyimpan dokumentasi. Jika Anda seorang pengembang atau homelabber yang ingin self host BookStack di VPS, panduan ini akan memandu Anda melalui proses instalasi langkah demi langkah. Kami akan menjelajahi instalasi menggunakan Docker, yang menyederhanakan penyebaran dan pengelolaan aplikasi.

Mengapa Menggunakan BookStack?

BookStack memungkinkan Anda membuat dokumentasi seperti wiki dengan fitur-fitur seperti:

• Halaman bersarang
• Dukungan Markdown
• Peran dan izin pengguna
• Kemampuan pencarian bawaan

Ini menjadikan BookStack pilihan ideal bagi siapa saja yang ingin membangun dan memelihara dokumentasi untuk proyek atau penggunaan pribadi.

Memilih Penyedia VPS

Terdapat beberapa penyedia VPS yang bisa dipilih sesuai anggaran dan kebutuhan Anda. Berikut perbandingan singkat dari penyedia populer:

Saat memilih penyedia VPS, pertimbangkan faktor seperti harga, performa, dan kemudahan penggunaan. Jika ragu, lihat perbandingan VPS lengkap untuk opsi lainnya.

Menyiapkan VPS Anda

1. Deploy VPS Anda: Pilih penyedia dari tabel dan siapkan VPS Anda. Pilih distribusi Linux favorit Anda (Ubuntu/Debian disarankan).

2. Akses Server Anda: Gunakan SSH untuk terhubung ke server. Bisa menggunakan aplikasi terminal seperti PuTTY atau terminal sistem Anda.

   ssh username@your_vps_ip

3. Perbarui Sistem Anda: Selalu perbarui sistem Anda.

   sudo apt update && sudo apt upgrade -y

Menginstal Docker

BookStack dapat dijalankan dengan mudah menggunakan Docker. Instal Docker dengan menjalankan perintah berikut:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Anda dapat memverifikasi pemasangan dengan memeriksa versi Docker:

docker --version

Menginstal Docker Compose

Docker Compose adalah alat untuk mendefinisikan dan menjalankan aplikasi Docker multi-kontainer. Instal Docker Compose dengan perintah berikut:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Periksa bahwa Docker Compose telah terpasang:

docker-compose --version

Menyebarkan BookStack

1. Buat Direktori untuk BookStack:

   mkdir ~/bookstack
   cd ~/bookstack

2. Buat File docker-compose.yml:

   Gunakan editor teks favorit Anda untuk membuat file ini:

   nano docker-compose.yml

   Tambahkan konfigurasi berikut:

   version: '2'
   services:
     bookstack:
       image: solidnerd/bookstack
       ports:
         - "80:80"
       environment:
         - DB_HOST=db
         - DB_USER=bookstack
         - DB_PASS=bookstackpassword
         - DB_DATABASE=bookstack
       depends_on:
         - db
   
     db:
       image: mysql:5.7
       environment:
         - MYSQL_ROOT_PASSWORD=rootpassword
         - MYSQL_DATABASE=bookstack
         - MYSQL_USER=bookstack
         - MYSQL_PASSWORD=bookstackpassword
       volumes:
         - db_data:/var/lib/mysql
   
   volumes:
     db_data:

   Sesuaikan password database sesuai kebutuhan.

3. Mulai Kontainer:

   Jalankan perintah berikut untuk memulai BookStack:

   docker-compose up -d

   Perintah ini akan mengunduh gambar yang diperlukan dan menjalankannya dalam mode detachd.

4. Akses BookStack:

   Buka browser dan kunjungi http://your_vps_ip. Anda akan melihat halaman pengaturan BookStack. Ikuti instruksi di layar untuk menyelesaikan instalasi.

Mengelola BookStack

Anda dapat mengelola BookStack melalui antarmuka web. Anda bisa menambahkan pengguna, membuat buku berbeda, bab, dan halaman sesuai kebutuhan.

Tanya Jawab Umum

Q1: Bisakah saya menjalankan BookStack tanpa Docker?

Ya, Anda bisa menginstal BookStack tanpa Docker, tetapi membutuhkan pengaturan manual yang lebih lengkap, termasuk mengonfigurasi PHP, MariaDB, dan server web seperti Apache atau Nginx. Docker menyederhanakan proses ini secara signifikan, memungkinkan penyebaran dan pembaruan yang lebih mudah.

Q2: Bagaimana saya melakukan backup instalasi BookStack saya?

Untuk membackup instalasi BookStack, Anda perlu membackup database dan file aplikasi. Anda dapat melakukannya dengan menggunakan perintah Docker untuk menyalin file database dan menyimpan data dari direktori BookStack Anda. Otomatisasi ini lewat skrip bisa membuat proses backup lebih efisien.

Q3: Apakah BookStack aman untuk self-hosting?

BookStack cukup aman, terutama saat di-host sendiri. Penting untuk menggunakan password kuat, menjaga perangkat lunak tetap terbaru, dan mengonfigurasi aturan firewall yang tepat. Selain itu, menggunakan SSL (melalui Let’s Encrypt atau sejenisnya) membantu memastikan akses aman ke instance BookStack Anda di web.

Kesimpulan

Self hosting BookStack di VPS menawarkan cara yang kuat untuk mengelola kebutuhan dokumentasi Anda. Dengan langkah-langkah dalam panduan ini, Anda dapat dengan efisien menyebar dan mengelola instance BookStack Anda sendiri. Jangan lupa untuk menjelajahi fitur-fitur BookStack dan menyesuaikannya sesuai kebutuhan saat Anda mengembangkan basis pengetahuan Anda. Untuk opsi lain dan perbandingan penyedia VPS, lihat perbandingan VPS lengkap. Selamat hosting!