Şirket bilgisinin büyük kısmı ya birkaç kişinin aklında ya da paylaşılan klasörlerdeki dağınık belgelerde durur: kurulum notları, süreç tarifleri, müşteri talimatları, yeni çalışan rehberleri. Bir şirket içi wiki bu bilgiyi aranabilir ve güncel tutulabilir hale getirir. BookStack, Confluence ve Notion'ın kendi sunucunuzda çalışan, MIT lisanslı ve sade bir alternatifidir. Bu rehberde BookStack'in yapısını, gereksinimlerini, yetki ve giriş seçeneklerini, yedekleme ve güncelleme adımlarını resmi belgelere dayanarak (Ekim 2026, v26.09.1) anlatıyoruz.
BookStack nasıl düzenlenir?
BookStack içeriği bir kütüphane gibi düzenler: raflar (shelves) kitapları gruplar, kitaplar konuları, isteğe bağlı bölümler (chapters) alt başlıkları, sayfalar da asıl içeriği tutar. Bu yapı, "her şey tek bir sayfa ağacında" yaklaşımına göre yeni gelen çalışanın yolunu bulmasını kolaylaştırır. Örnek bir düzen: "Satış" rafında teklif süreci ve fiyatlandırma kitapları, "Teknik" rafında sunucu ve yedekleme kitapları.
- Editör: varsayılan editör WYSIWYG'dir (Word benzeri), isteyen kullanıcılar Markdown editörüne geçebilir.
- Çizimler: diagrams.net (draw.io) entegrasyonuyla akış şemaları sayfanın içinde çizilip düzenlenir.
- Arama ve etiketler: tüm içerikte arama ve etiketlerle filtreleme.
- Dışa aktarma: HTML, PDF, düz metin, Markdown ve v24.12'den beri yeniden içe aktarılabilen "Portable ZIP". PDF çıktısı varsayılan olarak dompdf ile üretilir; belgeler bunun yeteneklerinin "biraz sınırlı" olduğunu belirtir ve harici bir PDF aracı tanımlanabilir.
Yetkiler, giriş ve iki aşamalı doğrulama
Kullanıcılara birden fazla rol verilebilir ve yetkiler birikir. Rol yetkileri raf, kitap, bölüm ve sayfa düzeyinde ayrıca daraltılıp genişletilebilir; örneğin İK kitabı yalnız İK rolüne açık tutulabilir. Giriş için LDAP (Active Directory), SAML 2.0 ve OpenID Connect desteklenir; Google, GitHub ve Microsoft gibi sosyal girişler de tanımlanabilir. Belgelere göre LDAP açıldığında standart kullanıcı adı/parola girişi kullanılamaz. Şirketin tüm uygulamalarında tek şifreyle giriş için Keycloak rehberimize bakabilirsiniz.
İki aşamalı doğrulama TOTP uygulamaları ve yedek kodlarla çalışır. Belgelere göre bir rolde "Requires Multi-Factor Authentication" seçeneği işaretlenerek o roldeki herkese zorunlu kılınabilir. Yönetici ve düzenleyici rollerinde açmanızı öneririz.
Arayüzün Türkçe çevirisi projenin dil dosyaları arasında yer alır; çeviriler topluluk tarafından Crowdin üzerinden yapılır.
Sunucu gereksinimleri ve kurulum
| Bileşen | Resmi gereksinim |
|---|---|
| PHP | 8.2 veya üzeri (curl, dom, gd, mbstring, pdo_mysql, zip vb. eklentilerle) |
| Veritabanı | MySQL 8.0+ ya da MariaDB 10.6+ |
| Web sunucusu | PHP ile çalışan herhangi bir web sunucusu (Apache, NGINX) |
| Barındırma | Komut satırı erişimi gerekir; paylaşımlı PHP hostingi desteklenmez |
Ubuntu 22.04, 24.04 ve 26.04 için yalnız temiz kurulmuş sisteme uygulanması gereken resmi kurulum betikleri vardır. Belgeler Docker için resmi bir imaj vermez, topluluk imajlarına (ör. LinuxServer.io) yönlendirir. Bir BookStack kurulumu tek bir wiki çalıştırır; birden fazla bağımsız wiki için ayrı kurulumlar gerekir.
Yedekleme ve güncelleme
Belgelere göre BookStack'in yerleşik bir yedekleme ve geri yükleme özelliği yoktur; yedek komut satırından alınır. Yedeklenmesi gerekenler:
- Veritabanı (mysqldump ile)
- .env dosyası: v26.09'dan itibaren APP_KEY değeri zorunludur ve belgeler, geri yükleme için gerekeceğinden bu değerin güvenli saklanmasını ister.
- public/uploads (sayfalardaki görseller) ve storage/uploads (ekler)
- Varsa themes klasörü (özelleştirmeler)
Yedek ve geri yükleme için bir "System CLI" aracı da vardır, ancak belgeler bu aracın v23.05'ten beri alfa aşamasında olduğunu ve henüz üretim için hazır sayılmadığını belirtir. Bu yüzden şirket ortamında klasik veritabanı dökümü ve dosya yedeğini esas almak daha güvenlidir.
Güncellemeden önce belgeler veritabanı ve yüklenen dosyaların yedeğinin alınmasını ister. Güncelleme git pull, composer install ve php artisan migrate adımlarıyla yapılır. Her sürüm için "sürüme özel talimatlar" bölümü ayrıca okunmalıdır. Yedek düzeni için restic rehberimize bakabilirsiniz.
BookStack kimler için uygun değil?
- Paylaşımlı hostingte çalıştırmak isteyenler: resmi olarak desteklenmez; VPS ya da sunucu gerekir.
- Wiki'yi veritabanı, görev listesi ya da proje aracı olarak kullanmak isteyenler: README, BookStack'in belgeleme dışındaki amaçlar için genişletilebilir bir platform olarak tasarlanmadığını söyler. Notion benzeri tablo ve veritabanı özellikleri için başka araçlara bakın (seçenekler için doküman yönetimi rehberimiz).
- Yüksek kaliteli PDF kitapçık üretmek isteyenler: varsayılan PDF çıktısı sınırlıdır; harici bir PDF aracı kurmak gerekir.
e-veri.com ile BookStack
BookStack'i Türkiye'deki sunucularımızda yönetilen hosting olarak ya da sizin sunucunuzda kuruyoruz. Kapsam:
- PHP ve MySQL ile kurulum, HTTPS
- LDAP veya SSO bağlantısı ve rol bazında zorunlu iki aşamalı doğrulama
- Raf ve kitap yapısının sizinle birlikte planlanması
- Mevcut belgelerin aktarılması
- Veritabanı ve dosya yedekleri, sürüm talimatlarına göre güncelleme
Teklif almak için kurumsal hizmetler sayfamızdaki formu kullanın.
Sık sorulan sorular
BookStack ücretsiz mi?
Evet. BookStack MIT lisanslıdır ve resmi SSS'ye göre ayrı bir kurumsal ya da ücretli sürümü yoktur; tüm özellikler tek, açık ve ücretsiz sürümdedir. Ücretli olan yalnız proje ekibinin sunduğu destek hizmetidir.
BookStack için hangi sunucu gerekir?
PHP 8.2 veya üzeri, MySQL 8.0+ ya da MariaDB 10.6+ ve bir web sunucusu. Komut satırı erişimi gerektiği için paylaşımlı PHP hostingi desteklenmez; VPS ya da sunucu kullanılmalıdır.
BookStack Active Directory ile çalışır mı?
Evet. LDAP (Active Directory dahil), SAML 2.0 ve OpenID Connect ile giriş desteklenir. LDAP açıldığında standart kullanıcı adı/parola girişi kullanılamaz.
BookStack'te iki aşamalı doğrulama zorunlu yapılabilir mi?
Evet. TOTP uygulamaları ve yedek kodlarla çalışan iki aşamalı doğrulama, rol ayarlarındaki "Requires Multi-Factor Authentication" seçeneğiyle o roldeki tüm kullanıcılara zorunlu kılınabilir.
BookStack yedeği nasıl alınır?
Yerleşik bir yedekleme özelliği yoktur. Veritabanı mysqldump ile, .env dosyası (APP_KEY dahil), public/uploads, storage/uploads ve varsa themes klasörü dosya olarak yedeklenir. Resmi System CLI aracı hâlâ alfa aşamasındadır.
BookStack'ten içerik dışa aktarılabilir mi?
Evet. Sayfa, bölüm ve kitaplar HTML, PDF, düz metin, Markdown ve yeniden içe aktarılabilen Portable ZIP olarak dışa aktarılabilir.
