SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor

BookStack, Wiki.js o Outline: Alin ang para sa iyo?

Ihambing ang BookStack, Wiki.js, at Outline sa setup, editor, login, at search. Alamin kung alin ang praktikal para sa solo admin at alin ang bagay sa teams.

Aling self-hosted wiki ang dapat mong patakbuhin

Inilalagay ng self-hosted wiki ang mga dokumento ng iyong team sa iisang searchable na lugar sa server na kontrolado mo. Magagawa ito ng BookStack, Wiki.js, at Outline. Pinakamalaki ang pagkakaiba nila sa dami ng kailangang i-assemble bago mag-load ang unang page, at sa kung sinu-sino ang pinapayagang mag-log in.

Pinakamadaling i-set up ang BookStack, at ito rin ang may pinakamatibay na paninindigan sa istruktura. Pinakamalawak naman ang pagpipilian ng editors sa Wiki.js habang nasa iisang page tree. Pinakamaganda ang writing experience ng Outline sa tatlo, at ayon sa documented production setup nito, kailangan ng external identity provider para malikha ang initial workspace.

Ang lahat ng nasa ibaba ay batay sa sariling documentation ng mga proyekto at sa mga inilathalang configuration file ng mga ito. Capability comparison ito, hindi benchmark. May petsa ang version numbers at requirements dahil patuloy na nagbabago ang tatlo.

Ang tunay na pagpipilian ay ang structure

Inaayos ng BookStack ang structure ng iyong content. Ang isang page ay nasa loob ng isang book, maaaring maglaman ng mga chapter ang isang book, at pinagsasama-sama ng shelves ang mga book. Hindi ka maaaring gumawa ng ikalimang level. Iyan ang pangunahing katangian ng product: alam ng bagong writer kung saan ilalagay ang isang page dahil iisa lamang ang puwesto nito. Ang kapalit nito, napipilitang ipasok sa structure ang content na hindi nito akma.

Gumagamit ang Wiki.js ng path tree, na katulad ng mga folder sa isang disk. Ang page sa ops/backup/restic ay napupunta kung saan mo ito ilalagay, at ikaw ang pumipili ng depth. Walang pumipigil sa dalawang tao na ilagay ang parehong subject sa magkaibang branch, kaya kailangan ng isang Wiki.js instance ng isang taong responsable sa tree.

Gumagamit ang Outline ng collections na may mga document na nakapugad sa loob ng ibang document. Ang paglipat ng document ay ginagawa sa pamamagitan ng pag-drag gamit ang mouse. Ito ang pinaka-flexible sa tatlo, kaya ito rin ang pinakamadaling hayaang mawalan ng maayos na structure.

BookStack: ang pinakamaliit na installation

Ang BookStack ay isang PHP application na gumagamit ng MySQL. Noong October 2026, ang dokumentadong requirements ay PHP 8.2 o mas bago at alinman sa MySQL 8.0 o MariaDB 10.6 o mas bago, kasama ang Composer 2.2 o mas bago kung mag-i-install ka mula sa source. Ang kasalukuyang release line ay 26.09, na inilabas noong September 24, 2026, at ang pinakabagong stable release ay v26.09.3, isang security release mula November 11, 2026. Simula 26.09, kailangang magtakda ng APP_KEY, na sakop na ng mga container step sa ibaba. Naglabas din ang BookStack ng critical PHP security notice noong October 21, 2026: i-update ang mga PHP package sa underlying system o i-pull at i-recreate ang container gamit ang patched image, dahil hindi sapat na patunay ang BookStack version lamang na patched ang PHP.

Opisyal na sinusuportahan ng project ang mga installation script at gabay para sa mga nakalistang Ubuntu LTS release nito, na kasalukuyang 22.04, 24.04 at 26.04. Paminsan-minsan, naglalabas din ito ng unsupported na mga gabay at script para sa ibang environment. Ini-install ng 24.04 script ang Apache, MySQL 8.0 at PHP 8.3 para sa iyo. Sa 26.04, gamitin ang installation-ubuntu-26.04.sh sa mga command sa ibaba; nag-i-install ito ng MySQL 8.4 at 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.sh

Basahin ang warning sa script na iyon bago ito patakbuhin. Nakasaad sa documentation na ito ay "ONLY FOR A FRESH OS, it will install Apache, MySQL 8.0 & PHP 8.3 and could OVERWRITE any existing web setup on the machine". Sinusuri ng 24.04 script kung may kasalukuyang Apache configuration at MySQL data, at ihihinto nito ang installation bago magsimula kung makita nito ang alinman sa mga iyon. Gumamit na lamang ng containers, o i-install nang mano-mano ang BookStack sa ibabaw ng kasalukuyang LAMP stack sa Ubuntu 24.04.

Gamit ng container route ang LinuxServer.io image, na isa sa dalawang community container setup na inililista ng BookStack documentation. Kailangan ng BookStack ng session encryption key at hindi ito makapagsisilbi ng mga page kung wala nito, kaya buuin muna ito.

docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

Kopyahin ang naka-print na value sa APP_KEY, saka isulat ang service. Kailangan din ng service na ito ng kasalukuyang MySQL o MariaDB database. Itakda ang mga value ng DB_* upang tumugma rito, dahil hindi gumagawa ng database service ang snippet.

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-stopped

Kailangang tumugma ang APP_URL sa address na aktuwal na tina-type ng mga reader, kasama ang scheme at anumang port. Itakda ito sa http://localhost, saka ihatid ang site gamit ang HTTPS. Kung hindi, ituturo ang mga nabuong link at redirect sa maling host, at makikita ito ng mga reader bilang login page na paulit-ulit na bumabalik sa sarili nito. Kung bago sa iyo ang compose files, magsimula muna sa mga pangunahing kaalaman sa Docker Compose sa VPS bago ito.

Simulan ito at tiyaking sumasagot ang application, hindi lamang na tumatakbo ang container:

docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:6875/login

Ang 200 OK ay nangangahulugang nag-boot ang PHP application at nakakonekta ito sa database. Kailangan ng 500 ang application error log para matukoy ang problema. Bilang default, isinusulat ng BookStack ang mga error nito sa isang log file sa halip na sa container output. Buksan ang ./config/log/bookstack/laravel.log sa host upang makita ang sanhi. Ipinapakita ng docker compose logs bookstack ang sariling startup message ng container, na maaaring hindi naglalaman ng application error.

Wiki.js: isang tree, maraming editor

Ang Wiki.js ay isang Node.js application. Ang dokumentadong Docker setup para sa version 2 ay gumagamit ng PostgreSQL, bagama’t tinatanggap din ng version 2 ang MySQL, MariaDB, MSSQL at SQLite. Nangangailangan ang version 3 ng PostgreSQL 17 o 18. Ito ang compose file mula sa version 2 Docker page ng proyekto:

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:

Palitan nang sabay ang POSTGRES_PASSWORD at DB_PASS bago ito patakbuhin, dahil iisang credential ang mga ito at public ang sample value. Sadyang naka-pin ang tag sa ghcr.io/requarks/wiki:2. Hindi inirerekomenda ng documentation ang latest, dahil maaaring magpasok ng breaking changes ang bagong major version; hindi na itinalaga ang latest para sa version 3 o mas bago.

Naging stable ang version 3 noong November 1, 2026. Noong October 27, 2026, ang pinakabagong version 2 release ay 2.5.317, isang bug-fix build mula October 23, 2026 na nagre-rebuild ng image gamit ang pinakabagong Node security updates. Ang version 2 releases ay inilalabas na ngayon mula sa hiwalay na requarks/wiki-v2 repository, at sinusundan pa rin ng :2 image tag ang mga ito. Batay sa pagsusuri noong November 16, 2026, inililista ng version 3 installation documentation ang ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0 at ghcr.io/requarks/wiki:3.4 tags, kung saan ang mga image ay may tags para sa major, major.minor at major.minor.patch versions. Gamitin ang version 3 para sa bagong installation; ang compose example sa itaas ay version 2 setup pa rin. Ang naunang release na 2.5.316 mula October 2, 2026 ay nagdagdag ng export utility para mailipat ang content sa version 3 sa hinaharap. Ang kasalukuyang version 2 installation ay nangangailangan ng export at import papunta sa hiwalay na version 3 instance, hindi simpleng pagpapalit ng image tag habang tumatakbo; suriin ang permissions at i-configure muli ang authentication at storage pagkatapos ng migration.

Sa unang pag-load, gagabayan ka ng Wiki.js 2 sa in-browser setup na lumilikha ng administrator account. Hangga’t hindi mo ito natatapos, makukuha ng sinumang makakaabot sa port ang wizard na iyon. Kaya ilagay muna ang service sa likod ng reverse proxy at TLS (transport layer security) bago buksan ang firewall. Ang wiki na may sariling hostname ay natural na mailalagay sa likod ng Traefik sa harap ng ilang Docker app kapag higit sa isang service ang naka-host sa server.

Ang pagpili ng editor ang dahilan kung bakit pinipili ng mga tao ang Wiki.js. Maaaring maglaman ang isang version 2 instance ng Markdown pages, visual editor pages, raw HTML pages at AsciiDoc pages nang magkakatabi. Nakatutulong ito kapag nag-iimport ka ng lumang content sa format na ayaw mong i-convert. Maaari rin itong humantong sa pagkakaroon ng apat na house style sa iisang wiki. Kaya piliin ang default editor sa unang araw at itala ang desisyong iyon.

Outline: ang pinakamahusay na editor, ang pinakamabigat na prerequisite

Ang Outline ang karaniwang tinutukoy ng mga taong naghahanap ng tool sa notes na katulad ng mga commercial na produkto. Node.js application ito. Ang kasalukuyang release noong November 16, 2026 ay 1.13.0, na inilabas noong November 15, 2026. Inalis ng release na ito ang suporta para sa Node 20 at ginawang Node 26.13.1 ang Docker image nito, kaya i-update ang mga mas lumang installation. Para sa source installation, kailangan na ngayon ng Node 22.23.5, 24.22.3, o 26.13.1 o mas bago. Inililista ng sample environment file nito ang mga kailangan: PostgreSQL sa pamamagitan ng DATABASE_URL, Redis sa pamamagitan ng REDIS_URL, dalawang random secret, at isang publicly reachable na URL.

openssl rand -hex 32
openssl rand -hex 32

Patakbuhin ito nang dalawang beses at itago ang dalawang value. Ang una ay gagamitin bilang SECRET_KEY at ang pangalawa bilang UTILS_SECRET. Ganito ang magiging hitsura ng pangunahing bahagi ng environment file:

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/data

Tama lamang ang PGSSLMODE=disable kapag nasa parehong machine o parehong Docker network ang database. Huwag itong isama kung ina-access ang database sa network, dahil magiging unencrypted ang connection. Hindi ka na pinipilit ng attachments na gumamit ng object storage: isinusulat ng FILE_STORAGE=local ang mga upload sa directory sa itaas. Dapat itong volume na maaaring sulatan ng container at kasama sa iyong backups. Itakda ang FILE_STORAGE=s3 gamit ang mga value ng AWS_* kung gusto mong ilagay ang mga file na iyon sa isang S3-compatible bucket.

Narito ang bahaging kadalasang ikinagugulat ng mga user. Walang built-in na username at password login ang Outline. Ayon sa sarili nitong sample configuration, kailangan ang credentials para sa third-party sign-in: "at least ONE OF these is required for a working installation or you'll have no sign-in options". Kabilang sa mga dokumentadong provider ang Google, Slack, Microsoft Entra, Discord, at anumang generic OpenID Connect (OIDC) server sa pamamagitan ng OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_AUTH_URI, OIDC_TOKEN_URI at OIDC_USERINFO_URI. Maaari ring paganahin ng mga existing workspace ang passkeys at email links o codes. Kailangan ng SMTP para sa email login, at hindi nito nilalampasan ang SSO para sa mga account na naka-link sa isang SSO provider.

Kaya ang aktuwal na kailangan sa documented production setup ng Outline ay Outline, PostgreSQL, Redis, at isang identity provider. Kung gumagamit na ang team mo ng Google Workspace o Microsoft Entra para sa sign-in, nagiging napakaangkop ng Outline. Kung hindi, kailangan mo ring mag-self-host ng gaya ng Keycloak o Authentik. Isa itong karagdagang service na kailangang i-patch at i-back up. Maglaan ng sapat na memory: tinatayang 512 MB bawat web process ang gabay mismo ng Outline, na itinatakda ng WEB_CONCURRENCY, bukod pa sa database at Redis.

Paano pinamamahalaan ng bawat isa ang access control

Ang BookStack ay may built-in na local email at password accounts, at sumusuporta rin sa LDAP, SAML2, at OIDC bilang mga alternatibo. Ang mga permission ay itinatakda bawat role at maaaring i-override sa isang shelf, book, chapter, o page. Ang mga permission ng book at chapter ay namamana ng mga child content maliban kung may override; ang mga permission ng shelf ay kailangang i-copy nang manual sa mga book.

Ang Wiki.js ay mayroon ding local accounts at nag-aalok ng mahabang listahan ng mga authentication strategy na maaari mong i-enable sa admin area. Ang mga page rule nito ay nagpapahintulot o nagbabawal ng access base sa path pattern. Napakamakapangyarihan nito ngunit madaling magkamali, dahil ang isang rule na nagpapahintulot sa mga path na nagsisimula sa ops/ ay sumasaklaw sa bawat page na ilalagay mo sa ilalim ng path na iyon sa hinaharap.

Ginagamit ng Outline ang iyong identity provider para sa SSO membership, at sa loob ng Outline, kinokontrol mo ang access base sa collection, document, at group. Ang mga user na tinanggal sa identity provider ay madi-disconnect sa susunod na pag-load nila ng Outline; i-suspend sila sa loob ng Outline upang agad na tapusin ang mga kasalukuyang session.

Paano gumagana ang search sa bawat isa

Ang search ang dahilan kung bakit nagiging kapaki-pakinabang ang isang wiki o nauuwi lang ito sa pagiging imbakan ng mga nakalimutang file.

Ang BookStack ay naghahanap sa database at nagbibigay sa mga reader ng query language na matututunan sa loob ng isang minuto. Ang pag-quote sa isang phrase, gaya ng "london meeting", ay nangangailangan ng eksaktong string na iyon. Ang square brackets ay ginagamit sa pag-search ng tags: ang [location=london] ay nagtutugma batay sa tag name, value, o pareho, kung saan ang mga comparison ay kinabibilangan ng !=, >=, at like. Ang curly braces naman ay nagfi-filter ng metadata, gaya ng {created_after:2016-12-30}. Ang anumang exact term, tag, o filter term ay maaaring i-negate sa pamamagitan ng paglalagay ng - sa unahan nito. Nililimitahan ng BookStack kung ilang term ng bawat uri ang maaaring ilagay sa isang query, kaya ang napakahabang query ay pinuputol sa halip na patakbuhin.

Itinuturing ng Wiki.js 2 ang search bilang isang pluggable module. Ang mga documented engine ay ang basic database engine, PostgreSQL engine, Elasticsearch, Algolia, AWS CloudSearch, at Azure Search. Ang basic engine ay nagtutugma ng mga title, description, at path sa halip na ang mismong body ng page. Kung gumagamit ka ng PostgreSQL, lumipat sa PostgreSQL engine sa admin area dahil ginagamit nito ang sariling full text index ng database sa halip na simpleng pagtutugma lamang. Panatilihin ang Elasticsearch para sa isang wiki na sapat ang laki para tanggapin mo ang pagpapatakbo at pag-patch ng pangalawang search service.

Ang Outline ay naghahanap gamit ang PostgreSQL full text indexes. Ang built-in keyword search nito ay hindi nangangailangan ng hiwalay na search service. Para sa isang team wiki na may mababang bilang ng libu-libong dokumento, ito ang may pinakamaliit na maintenance sa tatlo.

Alin ang angkop sa iyo

Piliin ang BookStack kung gusto mong gumana ang wiki ngayong hapon at mas gugustuhin mong pagtalunan ang nilalaman kaysa ang istruktura. Ito ang may pinakakaunting moving parts: isang PHP application at isang MySQL database. Angkop ito para sa internal runbooks at dokumentasyon para sa customer, pati sa mga team na karamihan sa mga writer ay hindi engineer. Ito rin ang pinakamadaling i-back up sa tatlo, dahil binubuo ang state nito ng isang database dump, mga uploaded file, at ng .env configuration, kasama ang APP_KEY.

Piliin ang Wiki.js kung kailangan mo ng partikular na editor o authentication strategy na wala sa iba, o kung mag-i-import ka ng malaking koleksiyon ng kasalukuyang Markdown o AsciiDoc at gusto mong mapanatili ang path structure. Tanggapin na mas mabigat ang stack na patatakbuhin mo, at i-pin ang major version tag.

Piliin ang Outline kung pinakamahalaga ang kalidad ng pagsusulat, para sa team at hindi para sa publiko ang wiki, at mayroon ka nang identity provider. Kapalit nito, makukuha mo ang editor na talagang gustong gamitin ng mga tao. Huwag itong piliin bilang una mong self-hosted application.

Kung wala sa tatlo ang angkop, karaniwang nasa content type ang mismatch. Mas angkop ang mga na-scan na invoice at contract sa isang document management system gaya ng Paperless-ngx kaysa sa wiki, at ang sapilitang paglalagay sa mga ito roon ang dahilan kung bakit maraming wiki ang nauuwi sa hindi na ginagamit. Ang isa pang karaniwang mismatch ay ang pangangailangan sa workspace sa halip na wiki, kung saan nasa iisang canvas ang mga document, table, at whiteboard. Dito mas angkop ang isang self-hosted na AFFiNE workspace kaysa sa alinman sa tatlong nabanggit. Para sa mas malawak na pagtingin sa iba pang karapat-dapat ilagay sa sarili mong server, tingnan ang shortlist ng self-hosting para sa 2026.

Sizing at mga backup

Kasya ang tatlo sa isang maliit na VPS, pero magkakaiba ang realistic na minimum dahil sa mga component na nasa likod ng bawat isa. Isang application process at MySQL ang BookStack. Isang Node process at PostgreSQL ang Wiki.js. May Node process, PostgreSQL, at Redis ang Outline. Karaniwan ding may identity provider itong kasama, kaya ito ang nangangailangan ng dagdag na memory.

I-back up nang magkasama ang database at mga upload, at i-restore ang mga ito sa isang pansamantalang instance kahit isang beses bago umasa sa backup na iyon. Tantya lamang ang backup ng wiki na hindi pa na-restore. Para sa BookStack, nangangahulugan ito ng mysqldump at ng /config volume. Para sa Wiki.js at Outline, nangangahulugan ito ng pg_dump at ng data volume. Para sa Outline, isama rin ang anumang nasa FILE_STORAGE_LOCAL_ROOT_DIR.

FAQ

Aling self-hosted wiki ang pinakamadaling i-install?

BookStack. Isa itong PHP application na may MySQL database, at may installation script ang project para sa Ubuntu 24.04 na nagse-set up ng Apache, MySQL 8.0, at PHP 8.3 sa isang run. Kailangan ng container image ng isang APP_KEY, isang APP_URL, at credentials para sa isang umiiral na database. Nagdadagdag ang Wiki.js ng Node runtime at PostgreSQL server, habang nagdadagdag ang Outline ng Redis at external identity provider para sa dokumentadong initial setup nito.

Magagamit ko ba ang Outline nang walang Google o ibang SSO provider?

Kailangan ng dokumentadong production setup nito ng provider upang malikha ang initial workspace. Walang local username at password login ang Outline. Nakasaad sa sample configuration nito na kailangan ng kahit isang third-party sign-in provider; kung wala, wala kang anumang sign-in option. Maaari mong gamitin ang Google, Slack, Microsoft Entra, Discord, o anumang generic OpenID Connect server gaya ng self-hosted Keycloak o Authentik. Maaaring mag-enable ang mga umiiral na workspace ng passkeys o email links at codes. Kailangan ang SMTP para sa email login. Ang mga account na naka-link sa SSO ay gagamitin pa rin ang provider na iyon.

Wiki.js 3 o Wiki.js 2 ba ang dapat kong i-install?

Version 3 para sa bagong installation. Naging stable ito noong November 1, 2026, at inililista na ngayon ng installation documentation nito ang ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0, at ghcr.io/requarks/wiki:3.4 tags. I-pin ang major version tag sa halip na latest, na hindi na itinalaga para sa version 3 o mas bago. Naka-pin pa rin sa version 2 ang compose example sa itaas. Kailangang mag-export ng migration package ang mga umiiral na version 2 installation at i-import ito sa hiwalay na version 3 instance. Hindi suportadong upgrade ang pagpapalit lang ng image tag.

Magkakaiba ang kanilang mga kalakasan. Binibigyan ng BookStack ang mga reader ng query language na may exact phrases, mga tag filter gaya ng [location=london], at mga metadata filter gaya ng {created_after:2016-12-30}. Maaaring i-negate ang alinman sa mga terminong iyon gamit ang nauunang -. Hindi nangangailangan ng hiwalay na search service ang built-in keyword search ng Outline. Ang Wiki.js 2 ang pinaka-configurable dahil ikaw ang pumipili ng engine, at naghahanap ang PostgreSQL engine sa page bodies na hindi hinahanap ng basic engine.

Maaari ko bang ilipat ang content ko mula sa isa papunta sa iba sa hinaharap?

Bahagya, at dapat mong asahan ang manual na trabaho. Nag-e-export ng Markdown ang tatlo, ngunit tumatanggap ang built-in import ng BookStack ng Portable ZIP format nito. Kaya hindi direktang import route papunta sa BookStack ang Markdown lamang. Hindi maayos na napapanatili ang structure: walang katumbas sa nested documents ng Outline ang books at chapters ng BookStack, at hindi naimamapa ang mga path ng Wiki.js sa fixed hierarchy ng BookStack. Ang attachments, permissions, at page history ang pinakamalamang na mawala. Kaya mag-export ng sample at suriin ang mga ito bago ka magpasya sa migration.

Nakatulong ba ang artikulong ito?

#bookstack#wikijs#outline#wiki#self-hosting#knowledge-base