BookStack, Wiki.js, atau Outline: Mana yang Cocok?
Bandingkan BookStack, Wiki.js, dan Outline berdasarkan bobot instalasi, editor, login, dan pencarian. Temukan pilihan tepat untuk admin solo atau tim.
Wiki self-hosted mana yang sebaiknya Anda jalankan
Wiki self-hosted menempatkan dokumentasi tim Anda di satu tempat yang dapat dicari pada server yang Anda kendalikan. BookStack, Wiki.js, dan Outline semuanya dapat menjalankan fungsi tersebut. Perbedaan terbesar di antara ketiganya terletak pada banyaknya komponen yang harus Anda siapkan sebelum halaman pertama dapat dimuat, serta pihak yang diizinkan untuk login.
BookStack paling mudah disiapkan dan paling ketat dalam hal struktur. Wiki.js menawarkan pilihan editor yang paling beragam dalam satu hierarki halaman. Outline memberikan pengalaman menulis terbaik di antara ketiganya, dan dokumentasi setup produksinya mengharuskan penggunaan identity provider eksternal untuk membuat workspace awal.
Seluruh informasi di bawah ini diambil dari dokumentasi resmi proyek dan file konfigurasi yang mereka publikasikan. Ini adalah perbandingan kemampuan, bukan benchmark. Nomor versi dan persyaratan diberi tanggal karena ketiga proyek tersebut terus berubah.
Struktur adalah pilihan yang sebenarnya
BookStack menetapkan bentuk konten Anda. Sebuah halaman berada di dalam buku, buku dapat memuat bab, dan rak mengelompokkan buku. Anda tidak dapat membuat tingkat kelima. Batasan itu adalah inti produknya: penulis baru mengetahui lokasi halaman karena hanya ada satu tempat untuk meletakkannya. Konsekuensinya, konten yang tidak sesuai dengan bentuk tersebut harus dipaksakan masuk ke dalamnya.
Wiki.js menggunakan pohon path, seperti folder pada disk. Halaman di ops/backup/restic berada di lokasi yang Anda tentukan, dan Anda memilih kedalamannya. Tidak ada yang mencegah dua orang menempatkan subjek yang sama pada dua cabang berbeda. Karena itu, instance Wiki.js memerlukan satu orang yang bertanggung jawab atas pohon tersebut.
Outline menggunakan koleksi dengan dokumen yang dapat ditumpuk di dalam dokumen lain. Untuk memindahkan dokumen, Anda cukup menyeretnya dengan mouse. Dari ketiganya, Outline paling fleksibel. Karena itu, strukturnya juga paling mudah menjadi tidak konsisten.
BookStack: instalasi paling sederhana
BookStack adalah aplikasi PHP yang menggunakan MySQL sebagai backend. Per Oktober 2026, persyaratan yang didokumentasikan adalah PHP 8.2 atau yang lebih baru dan salah satu dari MySQL 8.0 atau MariaDB 10.6 atau yang lebih baru, serta Composer 2.2 atau yang lebih baru jika Anda menginstalnya dari source. Rilis saat ini berada pada lini 26.09, yang dirilis pada 24 September 2026, dan rilis stabil terbaru adalah v26.09.3, yaitu rilis keamanan dari 11 November 2026. Mulai 26.09, nilai APP_KEY harus ditetapkan. Langkah container di bawah ini sudah mencakupnya. BookStack juga menerbitkan pemberitahuan keamanan PHP kritis pada 21 Oktober 2026: perbarui paket PHP yang mendasarinya atau pull dan buat ulang container dengan image yang telah ditambal, karena versi BookStack saja tidak memastikan bahwa PHP sudah ditambal.
Proyek ini secara resmi mendukung script instalasi dan panduan untuk rilis Ubuntu LTS yang tercantum, yaitu 22.04, 24.04, dan 26.04 saat ini. Proyek ini juga terkadang menerbitkan panduan dan script yang tidak didukung untuk environment lain. Script 24.04 menginstalkan Apache, MySQL 8.0, dan PHP 8.3 untuk Anda. Pada 26.04, gunakan installation-ubuntu-26.04.sh dalam command di bawah ini. Script tersebut menginstalkan MySQL 8.4 dan PHP 8.5.
wget https://codeberg.org/bookstack/devops/raw/branch/main/scripts/installation-ubuntu-24.04.sh
chmod a+x installation-ubuntu-24.04.sh
sudo ./installation-ubuntu-24.04.shBaca peringatan pada script tersebut sebelum menjalankannya. Dokumentasi menyatakan bahwa script ini "HANYA UNTUK OS BARU, script ini akan menginstalkan Apache, MySQL 8.0 & PHP 8.3 dan dapat MENIMPA konfigurasi web apa pun yang sudah ada pada mesin". Script 24.04 memeriksa konfigurasi Apache dan data MySQL yang sudah ada. Script tersebut membatalkan instalasi sebelum dimulai jika menemukan salah satunya. Gunakan container sebagai gantinya, atau instal BookStack secara manual di atas LAMP stack yang sudah ada pada Ubuntu 24.04.
Rute container menggunakan image LinuxServer.io, salah satu dari dua setup container komunitas yang dicantumkan dalam dokumentasi BookStack. BookStack memerlukan kunci enkripsi sesi dan tidak akan menyajikan halaman tanpa kunci tersebut. Karena itu, buat kunci terlebih dahulu.
docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkeySalin nilai yang dicetak ke dalam APP_KEY, lalu tulis service tersebut. Service ini juga memerlukan database MySQL atau MariaDB yang sudah ada. Tetapkan nilai DB_* agar sesuai dengan database tersebut, karena snippet ini tidak membuat service database.
services:
bookstack:
image: lscr.io/linuxserver/bookstack:latest
container_name: bookstack
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
- APP_URL=https://wiki.example.com
- APP_KEY=paste_the_generated_key_here
- DB_HOST=bookstack_db
- DB_PORT=3306
- DB_USERNAME=bookstack
- DB_PASSWORD=change_me
- DB_DATABASE=bookstackapp
volumes:
- ./config:/config
ports:
- 6875:80
restart: unless-stoppedAPP_URL harus sesuai dengan alamat yang benar-benar diketik pembaca, termasuk skema dan port jika ada. Jika Anda menetapkannya ke http://localhost lalu menyajikan situs melalui HTTPS, link dan redirect yang dibuat akan mengarah ke host yang salah. Pembaca akan melihatnya sebagai halaman login yang terus mengarahkan kembali ke halaman itu sendiri. Jika file Compose masih baru bagi Anda, mulai dengan Dasar-dasar Docker Compose pada VPS sebelum mengikuti panduan ini.
Jalankan service tersebut dan periksa bahwa aplikasi merespons, bukan hanya bahwa container sedang berjalan:
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:6875/login200 OK berarti aplikasi PHP berhasil melakukan boot dan terhubung ke database. 500 memerlukan pemeriksaan log error aplikasi untuk diagnosis. Secara default, BookStack menulis error-nya ke file log, bukan ke output container. Karena itu, buka ./config/log/bookstack/laravel.log pada host untuk melihat penyebabnya. docker compose logs bookstack menampilkan pesan startup milik container, yang mungkin tidak mencakup error aplikasi.
Wiki.js: satu tree, beberapa editor
Wiki.js adalah aplikasi Node.js. Penyiapan Docker versi 2 yang didokumentasikan memasangkannya dengan PostgreSQL, meskipun versi 2 juga menerima MySQL, MariaDB, MSSQL, dan SQLite. Versi 3 memerlukan PostgreSQL 17 atau 18. Berikut adalah file compose dari halaman Docker versi 2 milik proyek tersebut:
services:
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: wiki
POSTGRES_PASSWORD: wikijsrocks
POSTGRES_USER: wikijs
logging:
driver: none
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
wiki:
image: ghcr.io/requarks/wiki:2
depends_on:
- db
init: true
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: wikijsrocks
DB_NAME: wiki
restart: unless-stopped
ports:
- "80:3000"
volumes:
db-data:Ubah POSTGRES_PASSWORD dan DB_PASS secara bersamaan sebelum menjalankannya karena keduanya merupakan satu kredensial dan nilai contoh tersebut bersifat publik. Tag dikunci ke ghcr.io/requarks/wiki:2 dengan sengaja. Dokumentasi menyarankan agar tidak menggunakan latest karena versi mayor baru dapat memperkenalkan perubahan yang tidak kompatibel; latest tidak lagi ditetapkan untuk versi 3 atau yang lebih baru.
Versi 3 menjadi stabil pada 1 November 2026. Per 27 Oktober 2026, rilis versi 2 terbaru adalah 2.5.317, build perbaikan bug dari 23 Oktober 2026 yang membangun ulang image dengan pembaruan keamanan Node terbaru. Rilis versi 2 kini dipublikasikan dari repositori requarks/wiki-v2 terpisah, dan tag image :2 masih mengikuti rilis tersebut. Berdasarkan pemeriksaan pada 16 November 2026, dokumentasi instalasi versi 3 mencantumkan tag ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0, dan ghcr.io/requarks/wiki:3.4, dengan image yang diberi tag berdasarkan versi mayor, mayor.minor, dan mayor.minor.patch. Gunakan versi 3 untuk instalasi baru; contoh compose di atas tetap merupakan penyiapan versi 2. Rilis sebelumnya, 2.5.316 dari 2 Oktober 2026, menambahkan utilitas ekspor untuk memindahkan konten ke versi 3 di kemudian hari. Instalasi versi 2 yang sudah ada memerlukan ekspor dan impor ke instance versi 3 terpisah, bukan sekadar mengganti tag image secara langsung; tinjau izin serta konfigurasi ulang autentikasi dan penyimpanan setelah migrasi.
Saat pertama kali dimuat, Wiki.js 2 memandu Anda melalui penyiapan dalam browser yang membuat akun administrator. Sebelum penyiapan selesai, siapa pun yang dapat mengakses port tersebut akan melihat wizard itu. Karena itu, tempatkan service di belakang reverse proxy dan TLS (transport layer security) sebelum membuka firewall. Wiki dengan hostname sendiri secara alami dapat ditempatkan di belakang Traefik di depan beberapa aplikasi Docker saat server menjalankan lebih dari satu service ini.
Pilihan editor adalah alasan orang memilih Wiki.js. Satu instance versi 2 dapat memuat halaman Markdown, halaman editor visual, halaman HTML mentah, dan halaman AsciiDoc secara berdampingan. Hal ini membantu ketika Anda mengimpor konten lama dalam format yang tidak ingin dikonversi. Namun, hal ini juga dapat menghasilkan empat gaya penulisan internal dalam satu wiki. Karena itu, tentukan editor default sejak hari pertama dan dokumentasikan keputusan tersebut.
Outline: editor terbaik dengan prasyarat paling berat
Outline adalah yang biasanya dimaksud orang ketika mereka menginginkan sesuatu yang terasa seperti alat catatan komersial. Outline merupakan aplikasi Node.js, dan rilis saat ini per 16 November 2026 adalah 1.13.0, yang dirilis pada 15 November 2026. Rilis tersebut menghentikan dukungan untuk Node 20 dan memperbarui image Docker ke Node 26.13.1, jadi perbarui instalasi lama. Instalasi dari source sekarang memerlukan Node 22.23.5, 24.22.3, atau 26.13.1 atau yang lebih baru. File environment contohnya mencantumkan kebutuhannya: PostgreSQL melalui DATABASE_URL, Redis melalui REDIS_URL, dua secret acak, dan URL yang dapat dijangkau secara publik.
openssl rand -hex 32
openssl rand -hex 32Jalankan perintah tersebut dua kali dan simpan kedua nilainya. Nilai pertama menjadi SECRET_KEY, sedangkan nilai kedua menjadi UTILS_SECRET. Bagian inti file environment kemudian terlihat seperti ini:
NODE_ENV=production
URL=https://docs.example.com
PORT=3000
SECRET_KEY=<first openssl value>
UTILS_SECRET=<second openssl value>
DATABASE_URL=postgres://outline:change_me@postgres:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://redis:6379
FILE_STORAGE=local
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/dataPGSSLMODE=disable hanya benar jika database berada pada mesin yang sama atau jaringan Docker yang sama. Hapus bagian tersebut untuk database yang diakses melalui jaringan, atau koneksi akan dikirim tanpa enkripsi. Attachment tidak lagi mengharuskan Anda menggunakan object storage: FILE_STORAGE=local menyimpan upload ke direktori di atas. Direktori tersebut harus berupa volume yang dapat ditulisi oleh container dan disertakan dalam backup Anda. Tetapkan FILE_STORAGE=s3 menggunakan nilai AWS_* jika Anda ingin menyimpan file tersebut di bucket yang kompatibel dengan S3.
Sekarang bagian yang sering mengejutkan pengguna. Outline tidak memiliki login username dan password bawaan. Konfigurasi contoh Outline sendiri menyatakan bahwa kredensial login pihak ketiga diperlukan: "at least ONE OF these is required for a working installation or you'll have no sign-in options". Provider yang didokumentasikan mencakup Google, Slack, Microsoft Entra, Discord, dan server OpenID Connect (OIDC) generik melalui OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_AUTH_URI, OIDC_TOKEN_URI, dan OIDC_USERINFO_URI. Workspace yang sudah ada juga dapat mengaktifkan passkey serta tautan atau kode melalui email. Login melalui email memerlukan SMTP dan tidak melewati SSO untuk akun yang ditautkan ke provider SSO.
Jadi, biaya sebenarnya dari setup produksi Outline yang didokumentasikan adalah Outline, PostgreSQL, Redis, dan identity provider. Jika tim Anda sudah login menggunakan Google Workspace atau Microsoft Entra, Outline menjadi sangat menarik. Jika belum, Anda juga harus melakukan self-hosting terhadap sesuatu seperti Keycloak atau Authentik. Itu berarti ada service kedua yang harus diperbarui dan dicadangkan. Perhitungkan penggunaan memory dengan tepat: panduan Outline sendiri memperkirakan sekitar 512 MB untuk setiap proses web, yang ditetapkan melalui WEB_CONCURRENCY, di luar kebutuhan database dan Redis.
Cara masing-masing menangani pihak yang boleh membaca konten
BookStack menyediakan akun lokal dengan email dan kata sandi secara bawaan, serta mendukung LDAP, SAML2, dan OIDC sebagai alternatif. Izin ditetapkan berdasarkan peran dan dapat ditimpa pada satu shelf, book, chapter, atau page. Izin pada book dan chapter diwariskan ke konten turunannya, kecuali ditimpa; izin pada shelf harus disalin ke book secara eksplisit.
Wiki.js juga menyediakan akun lokal dan menambahkan banyak strategi autentikasi yang dapat diaktifkan di area admin. Aturan page memberikan atau menolak akses berdasarkan pola path. Fitur ini fleksibel, tetapi mudah salah dikonfigurasi, karena aturan yang mengizinkan path yang diawali dengan ops/ akan mencakup setiap page yang nantinya Anda simpan di bawah path tersebut.
Outline menggunakan identity provider Anda untuk keanggotaan SSO. Di dalam Outline, Anda mengatur akses berdasarkan collection, document, dan group. Pengguna yang dihapus dari identity provider akan logout saat berikutnya memuat Outline. Tangguhkan pengguna tersebut di Outline untuk segera mengakhiri sesi yang sedang aktif.
Cara kerja pencarian pada masing-masing
Pencarian menentukan apakah sebuah wiki benar-benar berguna atau hanya menjadi folder berisi file yang terlupakan.
BookStack melakukan pencarian pada database dan menyediakan bahasa kueri yang dapat dipelajari pembaca dalam satu menit. Penggunaan tanda kutip pada frasa, seperti pada "london meeting", mengharuskan string tersebut sama persis. Tanda kurung siku digunakan untuk mencari tag: [location=london] mencocokkan berdasarkan nama tag, nilai, atau keduanya, dengan perbandingan yang mencakup !=, >=, dan like. Tanda kurung kurawal digunakan untuk memfilter metadata, seperti pada {created_after:2016-12-30}. Istilah exact, tag, atau filter apa pun dapat dinegasikan dengan menambahkan - di awal. BookStack membatasi jumlah istilah untuk setiap jenis yang dapat dimuat dalam satu kueri, sehingga kueri yang sangat panjang akan dipangkas, bukan dijalankan.
Wiki.js 2 memperlakukan pencarian sebagai modul yang dapat dipasang. Engine yang didokumentasikan adalah basic database engine, PostgreSQL engine, Elasticsearch, Algolia, AWS CloudSearch, dan Azure Search. Basic engine mencocokkan judul, deskripsi, dan path, bukan isi halaman. Jika Anda menggunakan PostgreSQL, alihkan ke PostgreSQL engine di area admin karena engine ini menggunakan indeks full text milik database, bukan pencocokan sederhana. Gunakan Elasticsearch untuk wiki yang cukup besar sehingga Anda bersedia menjalankan dan melakukan patch pada search service kedua.
Outline melakukan pencarian pada indeks full text PostgreSQL. Fitur pencarian kata kunci bawaannya tidak memerlukan search service terpisah. Untuk wiki tim dengan jumlah dokumen beberapa ribu, Outline memerlukan pekerjaan paling sedikit di antara ketiganya.
Mana yang paling sesuai untuk Anda
Pilih BookStack jika Anda ingin wiki berjalan sore ini dan lebih suka membahas konten daripada struktur. Komponennya paling sedikit: satu aplikasi PHP dan satu database MySQL. BookStack cocok untuk runbook internal dan dokumentasi pelanggan, serta untuk tim yang sebagian besar penulisnya bukan engineer. BookStack juga paling mudah dicadangkan di antara ketiganya karena seluruh state terdiri atas satu database dump, file yang diunggah, dan konfigurasi .env, termasuk APP_KEY.
Pilih Wiki.js jika Anda memerlukan editor tertentu atau strategi autentikasi tertentu yang tidak ditawarkan oleh produk lain, atau jika Anda mengimpor banyak Markdown atau AsciiDoc yang sudah ada dan ingin mempertahankan struktur path. Terima bahwa Anda menjalankan stack yang lebih berat, lalu tetapkan tag major version.
Pilih Outline jika kualitas penulisan adalah prioritas utama, wiki ditujukan untuk tim dan bukan untuk publik, serta Anda sudah memiliki identity provider. Setup tersebut memberikan editor yang benar-benar nyaman digunakan. Jangan memilihnya sebagai aplikasi self-hosted pertama Anda.
Jika tidak satu pun dari ketiganya sesuai, biasanya masalahnya terletak pada jenis konten. Invoice dan kontrak hasil pemindaian lebih sesuai disimpan dalam sistem manajemen dokumen seperti Paperless-ngx daripada dalam wiki. Memaksakan dokumen tersebut ke dalam wiki adalah alasan banyak wiki akhirnya ditinggalkan. Ketidaksesuaian umum lainnya adalah ketika Anda memerlukan workspace, bukan wiki, dengan dokumen, tabel, dan whiteboard dalam satu canvas. Dalam kasus tersebut, workspace AFFiNE self-hosted lebih sesuai daripada ketiga pilihan di atas. Untuk melihat pilihan yang lebih luas tentang aplikasi lain yang layak dijalankan di server Anda sendiri, lihat daftar pilihan self-hosting untuk 2026.
Ukuran dan backup
Ketiganya dapat berjalan pada VPS kecil. Kebutuhan minimum yang realistis berbeda karena komponen yang digunakan masing-masing aplikasi juga berbeda. BookStack menggunakan satu proses aplikasi dan MySQL. Wiki.js menggunakan proses Node dan PostgreSQL. Outline menggunakan proses Node, PostgreSQL, dan Redis, biasanya bersama penyedia identitas. Karena itu, Outline memerlukan memori tambahan.
Cadangkan database dan file upload secara bersamaan. Sebelum mengandalkan backup tersebut, pulihkan keduanya satu kali ke instance sementara. Backup wiki yang belum pernah dipulihkan hanyalah perkiraan. Untuk BookStack, ini berarti mysqldump dan volume /config. Untuk Wiki.js dan Outline, ini berarti pg_dump dan volume data. Untuk Outline, cadangkan juga apa pun yang berada di FILE_STORAGE_LOCAL_ROOT_DIR.
FAQ
Wiki self-hosted mana yang paling mudah dipasang?
BookStack. Aplikasi ini terdiri atas satu aplikasi PHP dengan database MySQL. Proyeknya menyediakan skrip instalasi untuk Ubuntu 24.04 yang menyiapkan Apache, MySQL 8.0, dan PHP 8.3 dalam satu kali eksekusi. Image container memerlukan APP_KEY, APP_URL, dan kredensial untuk database yang sudah ada. Wiki.js menambahkan runtime Node dan server PostgreSQL. Outline menambahkan Redis dan identity provider eksternal untuk konfigurasi awal yang didokumentasikan.
Apakah Outline dapat digunakan tanpa Google atau provider SSO lain?
Konfigurasi produksi yang didokumentasikan memerlukan provider untuk membuat workspace awal. Outline tidak memiliki login lokal menggunakan username dan password. Konfigurasi contohnya menyatakan bahwa setidaknya satu provider sign-in pihak ketiga diperlukan. Tanpa provider tersebut, Anda tidak memiliki opsi sign-in sama sekali. Anda dapat menggunakan Google, Slack, Microsoft Entra, Discord, atau server OpenID Connect generik seperti Keycloak atau Authentik yang di-host sendiri. Workspace yang sudah ada dapat mengaktifkan passkey atau link dan kode melalui email. Login melalui email memerlukan SMTP. Akun yang ditautkan ke SSO tetap menggunakan provider tersebut.
Sebaiknya memasang Wiki.js 3 atau Wiki.js 2?
Gunakan versi 3 untuk instalasi baru. Versi ini menjadi stabil pada November 1, 2026. Dokumentasi instalasinya sekarang mencantumkan tag ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0, dan ghcr.io/requarks/wiki:3.4. Tetapkan tag major version, bukan latest, karena tag tersebut tidak lagi ditetapkan untuk versi 3 atau yang lebih baru. Contoh compose di atas tetap menggunakan versi 2. Instalasi versi 2 yang sudah ada harus mengekspor migration package, lalu mengimpornya ke instance versi 3 yang terpisah. Mengubah image tag saja bukan metode upgrade yang didukung.
Mana yang memiliki fitur pencarian terbaik?
Ketiganya unggul dalam aspek yang berbeda. BookStack menyediakan bahasa query untuk pembaca, dengan frasa persis, filter tag seperti [location=london], dan filter metadata seperti {created_after:2016-12-30}. Setiap istilah tersebut dapat dikecualikan dengan - di awal. Pencarian keyword bawaan Outline tidak memerlukan search service terpisah. Wiki.js 2 paling fleksibel untuk disesuaikan karena Anda dapat memilih engine. Engine PostgreSQL juga mencari isi halaman yang tidak dicari oleh engine dasar.
Apakah konten dapat dipindahkan dari satu platform ke platform lain nanti?
Sebagian, tetapi Anda harus memperkirakan adanya pekerjaan manual. Ketiganya dapat mengekspor Markdown. Namun, fitur import bawaan BookStack menerima format Portable ZIP. Karena itu, Markdown saja tidak dapat digunakan sebagai jalur import langsung ke BookStack. Struktur konten juga tidak dapat dipertahankan dengan baik. Book dan chapter BookStack tidak memiliki padanan dalam dokumen bertingkat Outline. Path Wiki.js juga tidak dapat dipetakan ke hierarki tetap BookStack. Attachment, permission, dan riwayat halaman adalah bagian yang paling mungkin hilang. Ekspor sampel terlebih dahulu dan periksa bagian-bagian tersebut sebelum memulai migrasi.