השוואת מערכות Wiki בניהול עצמי: BookStack, Wiki.js

איזה Wiki בניהול עצמי כדאי להריץ

Wiki בניהול עצמי מרכז את מסמכי הצוות במקום אחד הניתן לחיפוש, על שרת שבשליטתכם. BookStack, Wiki.js ו-Outline מבצעים כולם את המשימה הזו. ההבדל העיקרי ביניהם טמון בכמות ההכנות הנדרשת לפני טעינת הדף הראשון, ובמנגנוני ההרשאות לכניסת משתמשים.

BookStack הוא הקל ביותר להקמה והוא מגיע עם תפיסת עולם מגובשת לגבי מבנה התוכן. Wiki.js מציע את המבחר הרחב ביותר של עורכי תוכן תחת עץ דפים מאוחד. ל-Outline יש את חוויית הכתיבה הטובה ביותר מבין השלושה, אך תהליך ההתקנה המתועד שלו לסביבת production מחייב שימוש בספק זהות חיצוני לצורך יצירת סביבת העבודה הראשונית.

כל המידע להלן מבוסס על התיעוד הרשמי של הפרויקטים ועל קובצי התצורה שפורסמו על ידם. זוהי השוואת יכולות, לא מדד ביצועים (benchmark). מספרי הגרסאות והדרישות מצוינים עם תאריך, כיוון שכל שלושת הפרויקטים מתעדכנים בתדירות גבוהה.

המבנה הוא הבחירה האמיתית

BookStack מקבע את צורת התוכן שלכם. דף חי בתוך ספר, ספר יכול להכיל פרקים, ומדפים מקבצים ספרים. לא ניתן להמציא רמה חמישית. המגבלה הזו היא המוצר: כותב חדש יודע היכן דף אמור להיות, כי יש רק מקום אחד שבו הוא יכול להימצא. המחיר הוא שתוכן שאינו מתאים לצורה הזו נאלץ להשתלב בה בכוח.

Wiki.js משתמש בעץ נתיבים, בדומה לתיקיות על דיסק. דף ב-ops/backup/restic נמצא בכל מקום שבו תניחו אותו, ואתם בוחרים את העומק. שום דבר לא מונע משני אנשים לתייק את אותו נושא תחת שני ענפים שונים, לכן מופע של Wiki.js זקוק לאדם אחד שאחראי על העץ.

Outline משתמש באוספים עם מסמכים המקוננים בתוך מסמכים. העברת מסמך מתבצעת בגרירה עם העכבר. זהו הכלי הגמיש ביותר מבין השלושה, ולכן הוא גם הקל ביותר לאיבוד סדר.

BookStack: ההתקנה המינימלית

BookStack הוא יישום PHP המבוסס על MySQL. נכון לאוקטובר 2026, הדרישות המתועדות הן PHP 8.2 ומעלה, וכן MySQL 8.0 או MariaDB 10.6 ומעלה, בתוספת Composer 2.2 ומעלה אם ההתקנה מתבצעת מקוד המקור. קו הגרסאות הנוכחי הוא 26.09, ששוחרר ב-24 בספטמבר 2026, והגרסה היציבה החדשה ביותר היא 26.09.2, עדכון אבטחה מה-20 באוקטובר 2026. החל מגרסה 26.09, חובה להגדיר ערך APP_KEY, דבר ששלבי המכולה להלן כבר מכסים. בנוסף, ב-21 באוקטובר 2026 פרסם הפרויקט התראת אבטחה קריטית ל-PHP: יש לעדכן את חבילות ה-PHP הבסיסיות או למשוך מחדש וליצור את המכולה עם אימג' מתוקן, שכן גרסת BookStack לבדה אינה מבטיחה ש-PHP מעודכן.

הפרויקט תומך רשמית בסקריפטים של התקנה ובהנחיות עבור גרסאות Ubuntu LTS המפורטות, נכון לעכשיו 22.04, 24.04 ו-26.04, ולעיתים מפרסם מדריכים וסקריפטים לא נתמכים עבור סביבות אחרות. הסקריפט עבור 24.04 מתקין עבורכם Apache, MySQL 8.0 ו-PHP 8.3. בגרסת 26.04, השתמשו ב-installation-ubuntu-26.04.sh בפקודות להלן במקום זאת; הוא מתקין MySQL 8.4 ו-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

קראו את האזהרה על הסקריפט לפני הרצתו. התיעוד מציין כי הוא "מיועד למערכת הפעלה נקייה בלבד, הוא יתקין Apache, MySQL 8.0 ו-PHP 8.3 ועלול לדרוס כל הגדרת אינטרנט קיימת על המכונה". הסקריפט עבור 24.04 בודק קיום של הגדרות Apache ונתוני MySQL ומפסיק את הפעולה לפני ההתקנה אם הוא מוצא אחד מהם. השתמשו במכולות במקרה כזה, או התקינו את BookStack ידנית על גבי מחסנית LAMP קיימת ב-Ubuntu 24.04.

נתיב המכולות משתמש באימג' של LinuxServer.io, אחת משתי תצורות המכולה הקהילתיות שמתועדות ב-BookStack. BookStack זקוק למפתח הצפנת סשן ולא יציג דפים בלעדיו, לכן צרו אותו תחילה.

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

העתיקו את הערך המודפס לתוך APP_KEY, ולאחר מכן כתבו את השירות. שירות זה זקוק גם למסד נתונים קיים של MySQL או MariaDB; הגדירו את ערכי DB_* כך שיתאימו לו, כיוון שהקטע אינו יוצר שירות מסד נתונים.

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

על APP_URL להתאים לכתובת שהקוראים מקלידים בפועל, כולל הסכימה וכל פורט. הגדירו אותו ל-http://localhost ולאחר מכן הגישו את האתר ב-HTTPS, אחרת הקישורים וההפניות שייווצרו יצביעו על מארח שגוי, מה שהקוראים יראו כדף התחברות שחוזר על עצמו בלולאה. אם קובצי compose חדשים לכם, התחילו עם יסודות Docker Compose ב-VPS לפני שתמשיכו.

העלו את השירות ובדקו שהיישום מגיב, לא רק שהמכולה רצה:

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

200 OK משמעותו שיישום ה-PHP עלה והגיע למסד הנתונים. 500 דורש את לוג השגיאות של היישום לצורך אבחון. כברירת מחדל, BookStack כותב את השגיאות שלו לקובץ לוג ולא לפלט של המכולה, לכן פתחו את ./config/log/bookstack/laravel.log על המארח כדי לראות את הסיבה. docker compose logs bookstack מציג את הודעות העלייה של המכולה עצמה, שעשויות שלא לכלול את שגיאת היישום.

Wiki.js: עץ אחד, עורכים מרובים

Wiki.js הוא יישום Node.js. הגדרת ה-Docker המתועדת משדכת אותו ל-PostgreSQL, אם כי התוכנה מקבלת גם את MySQL, MariaDB, MSSQL ו-SQLite. זהו קובץ ה-compose מדף ה-Docker של הפרויקט עצמו:

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:

שנו את POSTGRES_PASSWORD ואת DB_PASS יחד לפני ההרצה, כיוון שהם מהווים הרשאה אחת והערך לדוגמה הוא ציבורי. התג נעול על ghcr.io/requarks/wiki:2 בכוונה. התיעוד ממליץ להימנע מ-latest, כיוון שקפיצת גרסה ראשית משנה את סכימת מסד הנתונים תחת מופע פעיל.

גרסה 2 היא הגרסה להרצה. נכון ל-27 באוקטובר 2026, גרסת ה-2 החדשה ביותר היא 2.5.317, גרסת תיקון באגים מה-23 באוקטובר 2026 שבונה מחדש את ה-image עם עדכוני האבטחה האחרונים של Node. גרסאות 2 מפורסמות כעת ממאגר requarks/wiki-v2 נפרד, ותג ה-image :2 עדיין עוקב אחריהן. גרסה 3 נמצאת ב-beta ציבורית. תיעוד ההתקנה שלה מציין שה-images שלה מתויגים כ-3.0.0-beta ושהתגים הפשוטים 3 ו-3.0 לא יעבדו עד לסיום שלב ה-beta. התייחסו אליה כאל תצוגה מקדימה, לא כיעד לסביבת ייצור. הגרסה הקודמת, 2.5.316 מה-2 באוקטובר 2026, הוסיפה כלי ייצוא להעברת תוכן לגרסה 3 במועד מאוחר יותר.

בטעינה הראשונה, Wiki.js מנחה אתכם דרך הגדרה בדפדפן שיוצרת את חשבון מנהל המערכת. עד שתסיימו, כל מי שיגיע לפורט יקבל את אשף ההגדרה הזה, לכן הציבו את השירות מאחורי ה-reverse proxy וה-TLS (אבטחת שכבת תעבורה) שלכם לפני פתיחת ה-firewall. ויקי בשם מתחם עצמאי יושב באופן טבעי מאחורי Traefik לפני מספר יישומי Docker כאשר השרת מארח יותר משירות זה בלבד.

בחירת העורך היא הסיבה שאנשים בוחרים ב-Wiki.js. מופע אחד יכול להכיל דפי Markdown, דפי עורך ויזואלי, דפי HTML גולמיים ודפי AsciiDoc זה לצד זה. זה עוזר כאשר מייבאים תוכן ישן בפורמט שמעדיפים לא להמיר. זו גם דרך לסיים עם ארבעה סגנונות עיצוב בוויקי אחד, לכן החליטו על עורך ברירת המחדל ביום הראשון ותעדו את ההחלטה הזו.

מתווה: העורך הטוב ביותר, דרישות הקדם הכבדות ביותר

Outline הוא מה שאנשים בדרך כלל מתכוונים אליו כשהם מחפשים כלי לניהול הערות בתחושה של מוצר מסחרי. זהו יישום Node.js, והגרסה העדכנית נכון ל-27 באוקטובר 2026 היא 1.12.0, מה-23 באוקטובר 2026. גרסה זו מעבירה את ה-Docker image שלה לגרסת Node שמתקנת מספר פגיעויות שפורסמו לאחרונה, לכן יש לעדכן התקנות ישנות. קובץ ה-environment לדוגמה מפרט את הצרכים שלו: PostgreSQL דרך DATABASE_URL, Redis דרך REDIS_URL, שני מפתחות סודיים אקראיים, ו-URL שניתן להגיע אליו מהאינטרנט.

openssl rand -hex 32
openssl rand -hex 32

הריצו פקודה זו פעמיים ושמרו את שני הערכים. הראשון יהפוך ל-SECRET_KEY, והשני ל-UTILS_SECRET. ליבת קובץ ה-environment נראית כך:

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

PGSSLMODE=disable נכון רק כאשר מסד הנתונים נמצא על אותו שרת או באותה רשת Docker. השמיטו אותו עבור מסד נתונים אליו ניגשים דרך הרשת, אחרת החיבור יעבור בטקסט גלוי. קבצים מצורפים אינם מחייבים עוד שימוש ב-object storage: FILE_STORAGE=local כותב העלאות לספרייה שמעל, שחייבת להיות volume שהמכולה יכולה לכתוב אליו ושכלול בגיבויים שלכם. הגדירו את FILE_STORAGE=s3 עם ערכי AWS_* במקום זאת, אם אתם מעוניינים שהקבצים יישמרו ב-bucket תואם S3.

כעת, החלק שמפתיע אנשים. ל-Outline אין מנגנון מובנה של שם משתמש וסיסמה. קובץ התצורה לדוגמה מציין במפורש שנדרשים פרטי התחברות של צד שלישי: "לפחות אחד מאלה נדרש עבור התקנה עובדת, אחרת לא יהיו אפשרויות התחברות". הספקים המתועדים כוללים את Google, Slack, Microsoft Entra, Discord, וכל שרת OpenID Connect (OIDC) גנרי דרך OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_AUTH_URI, OIDC_TOKEN_URI ו-OIDC_USERINFO_URI. סביבות עבודה קיימות יכולות גם להפעיל passkeys וקישורים או קודים במייל; התחברות במייל דורשת SMTP ואינה עוקפת SSO עבור חשבונות המקושרים לספק SSO.

לכן, העלות האמיתית של הגדרת הייצור המתועדת של Outline היא Outline בתוספת PostgreSQL, Redis וספק זהות. אם הצוות שלכם כבר מתחבר באמצעות Google Workspace או Microsoft Entra, Outline הופך לאטרקטיבי מאוד. אם לא, אתם נדרשים לארח בעצמכם גם שירות כמו Keycloak או Authentik, שהוא שירות נוסף שיש לתחזק ולגבות. תכננו את הזיכרון בהתאם: ההנחיה של Outline היא כ-512 MB לכל תהליך web, המוגדר על ידי WEB_CONCURRENCY, מעבר לצריכה של מסד הנתונים ו-Redis.

כיצד כל מערכת מנהלת הרשאות קריאה

ל-BookStack יש חשבונות דואר אלקטרוני וסיסמה מקומיים כברירת מחדל, והיא תומכת ב-LDAP, ב-SAML2 וב-OIDC כחלופות. הרשאות נקבעות לפי תפקיד וניתן לדרוס אותן ברמת מדף, ספר, פרק או דף בודד. הרשאות של ספרים ופרקים עוברות בירושה לתוכן שמתחתיהם אלא אם כן נדרסו; הרשאות של מדפים חייבות להיות מועתקות לספרים באופן מפורש.

גם ל-Wiki.js יש חשבונות מקומיים, והיא מוסיפה רשימה ארוכה של אסטרטגיות שניתן להפעיל באזור הניהול. חוקי הדפים שלה מעניקים או חוסמים גישה לפי תבנית נתיב. זו יכולת עוצמתית שקל לטעות בה, כיוון שחוק שנכתב עבור ops/* יחול באופן אוטומטי על כל דף שתשייך לנתיב זה בעתיד.

Outline משתמשת בספק הזהות שלך עבור חברות ב-SSO, ובתוך Outline אתה שולט בגישה לפי אוסף, מסמך וקבוצה. משתמשים שהוסרו מספק הזהות ינותקו מהמערכת בטעינה הבאה של Outline; השעה אותם בתוך Outline כדי לסיים סשנים קיימים באופן מיידי.

כיצד פועל החיפוש בכל מערכת

החיפוש הוא המקום שבו ה-wiki מוכיח את ערכו, או לחלופין הופך לאוסף של קבצים נשכחים.

BookStack מבצע חיפוש בבסיס הנתונים ומציע לקוראים שפת שאילתות שניתן ללמוד בדקה. ציטוט של ביטוי, כמו ב-"london meeting", מחייב התאמה מדויקת של המחרוזת. סוגריים מרובעים משמשים לחיפוש תגיות: [location=london] מבצע התאמה לפי שם תגית, ערך או שניהם, עם אפשרויות השוואה הכוללות את !=, >= ו-like. סוגריים מסולסלים מסננים לפי מטא-דאטה, כפי שמופיע ב-{created_after:2016-12-30}. ניתן לשלול כל מונח חיפוש מדויק, תגית או מסנן על ידי הוספת הקידומת -. BookStack מגביל את מספר המונחים מכל סוג ששאילתה אחת יכולה להכיל, כך ששאילתות ארוכות מדי נחתכות במקום להריץ אותן.

Wiki.js מתייחס לחיפוש כאל מודול הניתן להחלפה. המנועים המתועדים הם מנוע בסיסי מבוסס בסיס נתונים, מנוע PostgreSQL, Elasticsearch, Algolia, AWS CloudSearch ו-Azure Search. המנוע הבסיסי מבצע התאמה של כותרות, תיאורים ונתיבים, אך לא של גוף הדפים. אם אתם מריצים PostgreSQL, עברו למנוע ה-PostgreSQL באזור הניהול, כיוון שהוא משתמש באינדקס הטקסט המלא של בסיס הנתונים עצמו במקום בהתאמה פשוטה. שמרו את Elasticsearch עבור wiki גדול מספיק כדי להצדיק הרצה ותחזוקה של שירות חיפוש נוסף.

Outline מבצע חיפוש באינדקסים של טקסט מלא ב-PostgreSQL. מנוע חיפוש מילות המפתח המובנה שלו אינו דורש שירות חיפוש נפרד. עבור wiki צוותי המכיל אלפי מסמכים בודדים, זוהי האופציה שדורשת את מינימום העבודה מבין השלוש.

מה מתאים לך

בחר ב-BookStack אם ברצונך שה-wiki יפעל עוד היום, ואם אתה מעדיף להתווכח על התוכן מאשר על המבנה. יש לו הכי מעט רכיבים נעים: יישום PHP אחד ומסד נתונים MySQL אחד. הוא מתאים לתיעוד פנימי (runbooks) ולתיעוד לקוחות, ומתאים לצוותים שבהם רוב הכותבים אינם מהנדסים. הוא גם הקל ביותר לגיבוי מבין השלושה, כיוון שהמצב מורכב מ-dump אחד של מסד הנתונים בתוספת הקבצים שהועלו וקובץ התצורה .env, כולל APP_KEY.

בחר ב-Wiki.js אם אתה זקוק לעורך ספציפי או לאסטרטגיית אימות מסוימת שהאחרים אינם מציעים, או אם אתה מייבא כמות גדולה של תוכן קיים בפורמט Markdown או AsciiDoc ורוצה לשמר את מבנה הנתיבים. קבל את העובדה שאתה מריץ stack כבד יותר, והקפד להצמיד (pin) את תג הגרסה הראשית.

בחר ב-Outline אם איכות הכתיבה היא בראש סדר העדיפויות, אם ה-wiki מיועד לצוות ולא לקהל הרחב, ואם כבר יש לך ספק זהות (identity provider). הוא מתגמל הגדרה כזו בעורך שאנשים באמת נהנים להשתמש בו. אל תבחר בו כיישום הראשון שאתה מארח בעצמך.

אם אף אחד מהשלושה אינו מתאים, חוסר ההתאמה נובע בדרך כלל מסוג התוכן. חשבוניות וחוזים סרוקים מקומם ב-מערכת לניהול מסמכים כגון Paperless-ngx ולא ב-wiki, ודחיפתם לתוכו היא הסיבה לכך שכל כך הרבה אתרי wiki ננטשים בסופו של דבר. חוסר התאמה נפוץ נוסף הוא הרצון בסביבת עבודה (workspace) במקום ב-wiki, הכוללת מסמכים, טבלאות ולוח מחיק על קנבס אחד; במקרה כזה סביבת עבודה עצמית מסוג AFFiNE תתאים יותר מכל אחד משלושת הקודמים. למבט רחב יותר על מה עוד ראוי למקום בשרת שלך, עיין ב-רשימת המומלצים לאירוח עצמי לשנת 2026.

תכנון משאבים וגיבויים

כל השלושה מתאימים לשרת VPS קטן, אך רף המשאבים הריאלי משתנה בהתאם לרכיבים שמאחורי כל יישום. BookStack מורכב מתהליך יישום אחד ומ־MySQL. Wiki.js מורכב מתהליך Node ומ־PostgreSQL. Outline מורכב מתהליך Node, מסד נתונים PostgreSQL ו־Redis, ולרוב דורש גם ספק זהות (identity provider) לצידו, ולכן הוא היישום שדורש הקצאת זיכרון נוספת.

גבו את מסד הנתונים ואת תיקיית הקבצים שהועלו יחד, ובצעו שחזור של שניהם לתוך מופע זמני לפחות פעם אחת לפני שתסתמכו על הגיבוי. גיבוי של ויקי שאיש לא ביצע לו שחזור הוא בגדר ניחוש בלבד. עבור BookStack, המשמעות היא mysqldump בצירוף הנפח של /config. עבור Wiki.js ו־Outline, המשמעות היא pg_dump בצירוף נפח הנתונים, ועבור Outline יש לגבות גם את כל מה שנמצא בתוך FILE_STORAGE_LOCAL_ROOT_DIR.

FAQ

איזו מערכת Wiki לאירוח עצמי היא הקלה ביותר להתקנה?

BookStack. מדובר ביישום PHP יחיד עם מסד נתונים MySQL, והפרויקט מפיץ סקריפט התקנה עבור Ubuntu 24.04 שמגדיר Apache, MySQL 8.0 ו-PHP 8.3 בהרצה אחת. אימג' המכולה דורש APP_KEY, APP_URL ופרטי גישה למסד נתונים קיים. Wiki.js מוסיף סביבת הרצה של Node ושרת PostgreSQL, ו-Outline מוסיף Redis וספק זהות חיצוני עבור הגדרת ההתחלה המתועדת שלו.

האם ניתן להשתמש ב-Outline ללא Google או ספק SSO אחר?

הגדרת ה-production המתועדת שלו דורשת ספק כדי ליצור את סביבת העבודה הראשונית. ל-Outline אין אפשרות התחברות עם שם משתמש וסיסמה מקומיים. הגדרת הדוגמה שלו מציינת כי נדרש לפחות ספק התחברות אחד מצד שלישי, אחרת לא יהיו אפשרויות התחברות כלל. ניתן להשתמש ב-Google, Slack, Microsoft Entra, Discord, או בכל שרת OpenID Connect גנרי כגון Keycloak או Authentik באירוח עצמי. סביבות עבודה קיימות יכולות להפעיל passkeys או קישורים וקודים במייל, כאשר נדרש SMTP עבור התחברות במייל; חשבונות המקושרים ל-SSO עדיין משתמשים באותו ספק.

האם כדאי להתקין את Wiki.js 3 או את Wiki.js 2?

גרסה 2. נכון ל-27 באוקטובר 2026, גרסת ה-release החדשה ביותר של גרסה 2 היא 2.5.317, מה-23 באוקטובר 2026, וגרסה 3 היא עדיין בטא שהאימג'ים שלה נושאים תג 3.0.0-beta. קבעו את גרסת האימג' שלכם ל-ghcr.io/requarks/wiki:2 במקום ל-latest, כיוון ששינוי גרסה מרכזית משנה את ה-schema של מסד הנתונים תחת מופע פעיל.

לאיזו מערכת יש את החיפוש הטוב ביותר?

הן חזקות בדרכים שונות. BookStack מעניק לקוראים שפת שאילתות עם ביטויים מדויקים, מסנני תגיות כגון [location=london] ומסנני מטא-דאטה כגון {created_after:2016-12-30}, וניתן לשלול כל אחד מהמונחים הללו באמצעות - בתחילת הביטוי. חיפוש מילות המפתח המובנה של Outline אינו דורש שירות חיפוש נפרד. Wiki.js הוא הניתן לכיוונון הרב ביותר, כיוון שאתם בוחרים את המנוע, ומנוע ה-PostgreSQL מחפש בגופי דפים שהמנוע הבסיסי אינו סורק.

האם אוכל להעביר את התוכן שלי מאחת לשנייה בעתיד?

באופן חלקי, ועליכם לצפות לעבודה ידנית. כל השלוש מייצאות ל-Markdown, אך הייבוא המובנה של BookStack מקבל את פורמט ה-Portable ZIP שלו, כך ש-Markdown לבדו אינו נתיב ייבוא ישיר לתוך BookStack. המבנה אינו נשמר בצורה נקייה: לספרים ולפרקים של BookStack אין מקבילה במסמכים המקוננים של Outline, והנתיבים של Wiki.js אינם ממופים להיררכיה הקבועה של BookStack. קבצים מצורפים, הרשאות והיסטוריית דפים הם החלקים בעלי הסבירות הגבוהה ביותר לאובדן, לכן ייצאו דוגמה ובדקו אותם לפני שתתחייבו להגירה.