VPS Üzerinde BookStack'i Kendiniz Barındırma (Tam Kılavuz)

BookStack, dokümantasyonu düzenlemek ve depolamak için basit ve kendi kendine barındırılan bir platformdur. Eğer bir geliştirici veya ev ortamında çalışan biriyseniz ve BookStack’i VPS üzerinde kendiniz barındırmak istiyorsanız, bu kılavuz size adım adım kurulum sürecini anlatacaktır. Uygulamaların dağıtımını ve yönetimini kolaylaştıran Docker kullanımıyla kurulum esas alınacaktır.

Neden BookStack Kullanmalıyım?

BookStack, aşağıdaki özelliklerle wiki tarzı dokümantasyon oluşturmanızı sağlar:

• İç içe sayfalar
• Markdown desteği
• Kullanıcı rolleri ve izinler
• Yerleşik arama özellikleri

Bu özellikler sayesinde BookStack, projeler veya kişisel kullanım için dokümantasyon oluşturmak ve sürdürmek isteyenler için ideal bir tercih haline gelir.

VPS Sağlayıcısı Seçerken Dikkat Edilmesi Gerekenler

Bütçenize ve ihtiyaçlarınıza göre çeşitli VPS sağlayıcıları mevcuttur. İşte popüler sağlayıcıların hızlı karşılaştırması:

Bir VPS sağlayıcısı seçerken fiyatlandırma, performans ve kullanım kolaylığı gibi faktörleri göz önünde bulundurun. Eğer emin değilseniz, tüm VPS karşılaştırmamıza göz atabilirsiniz.

VPS Hazırlığı

1. VPS Kurulumu: Tabloyu inceleyerek uygun bir sağlayıcı seçin ve VPS’inizi kurun. Tercihinize göre Linux dağıtımı seçin (Ubuntu/Debian önerilir).

2. Sunucuya Erişim: SSH kullanarak sunucunuza bağlanın. PuTTY gibi bir terminal uygulaması veya sisteminizin terminalini kullanabilirsiniz.

   ssh kullanıcıadınız@sunucu_ip_nız

3. Sistem Güncelleme: Her zaman sisteminizi güncel tutun.

   sudo apt update && sudo apt upgrade -y

Docker Kurulumu

BookStack, Docker kullanılarak kolayca çalıştırılabilir. Docker’ı aşağıdaki komutlarla kurabilirsiniz:

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

Kurulumu doğrulamak için Docker sürümünü kontrol edebilirsiniz:

docker --version

Docker Compose Kurulumu

Docker Compose, çoklu konteynerli Docker uygulamalarını tanımlamak ve çalıştırmak için kullanılan bir araçtır. Kurulum aşağıdaki komutlarla yapılır:

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

Docker Compose’un yüklü olup olmadığını doğrulamak için:

docker-compose --version

BookStack Dağıtımı

1. BookStack için Bir Dizin Oluşturun:

   mkdir ~/bookstack
   cd ~/bookstack

2. docker-compose.yml Dosyasını Oluşturun:

   Tercih ettiğiniz metin düzenleyici ile dosyayı oluşturun:

   nano docker-compose.yml

   Aşağıdaki yapılandırmayı ekleyin:

   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:

   Veritabanı şifrelerini gerektiği gibi güncelleyin.

3. Konteynerleri Çalıştırın:

   BookStack’i başlatmak için aşağıdaki komutu kullanın:

   docker-compose up -d

   Bu komut, gerekli görüntüleri indirir ve arka planda çalıştırır.

4. BookStack’e Erişim:

   Web tarayıcınızda http://sunucu_ip_niz adresine gidin. BookStack kurulum sayfasını görmelisiniz. Ekranda gösterilen talimatları izleyerek kurulumu tamamlayın.

BookStack Yönetimi

BookStack’i web arayüzünden yönetebilirsiniz. Kullanıcı ekleyebilir, farklı kitaplar, bölümler ve sayfalar oluşturabilirsiniz.

Sık Sorulan Sorular

S1: BookStack’i Docker olmadan da çalıştırabilir miyim?

Evet, Docker olmadan da kurabilirsiniz, ancak bu daha fazla manuel yapılandırma gerektirir. PHP, MariaDB ve Apache veya Nginx gibi web sunucusunu yapılandırmanız gerekir. Docker bu süreci büyük ölçüde kolaylaştırır, dağıtım ve güncellemeleri basitleştirir.

S2: BookStack kurulumunun yedeğini nasıl alırım?

Kurulumun yedeğini almak için veritabanını ve uygulama dosyalarını yedeklemeniz gerekir. Docker komutlarıyla veritabanı dosyalarını kopyalayabilir ve BookStack dizininizdeki verileri kaydedebilirsiniz. Otomatik yedekleme scriptleri kullanmak bu süreci daha da kolaylaştırır.

S3: BookStack kendiniz barındırmak için güvenli midir?

BookStack kendiniz barındırıldığında göreceli olarak güvenlidir. Güçlü şifreler kullanmak, yazılımı güncel tutmak ve uygun güvenlik duvarı kuralları yapılandırmak önemlidir. Ayrıca, SSL kullanmak (Let’s Encrypt veya benzeri sertifikalarla) web üzerinden güvenli erişim sağlar.

Sonuç

VPS üzerinde BookStack’i kendiniz barındırmak, dokümantasyon ihtiyaçlarınızı güçlü bir şekilde karşılamanın harika bir yoludur. Bu kılavuzdaki adımlarla kendi BookStack örneğinizi verimli şekilde dağıtabilir ve yönetebilirsiniz. BookStack’in sunduğu çeşitli özellikleri keşfetmeyi ve ihtiyaçlarınıza göre özelleştirmeyi unutmayın. Diğer VPS sağlayıcıları ve karşılaştırmaları için tüm VPS karşılaştırmamıza göz atabilirsiniz. İyi barındırmalar!