BookStack، Wiki.js یا Outline: کون سا wiki بہتر ہے؟
BookStack، Wiki.js اور Outline کا self-hosted wiki موازنہ: setup، editing model، login اور search دیکھیں، پھر solo admin یا team کے لیے موزوں انتخاب کریں۔
کون سی self-hosted wiki چلانی چاہیے
self-hosted wiki آپ کی ٹیم کی دستاویزات کو آپ کے زیرِ انتظام سرور پر ایک searchable جگہ میں رکھتی ہے۔ BookStack، Wiki.js اور Outline، تینوں یہ کام کرتے ہیں۔ ان میں بنیادی فرق یہ ہے کہ پہلے صفحے کے load ہونے سے پہلے آپ کو کتنی configuration خود تیار کرنی پڑتی ہے، اور login کی اجازت کن صارفین کو ہوتی ہے۔
BookStack کو چلانا سب سے آسان ہے اور اس کا structure سب سے زیادہ متعین ہے۔ Wiki.js ایک ہی page tree کے اندر editors کے انتخاب کی سب سے زیادہ گنجائش دیتا ہے۔ Outline میں ان تینوں میں writing experience سب سے بہتر ہے، لیکن اس کے documented production setup میں initial workspace بنانے کے لیے بیرونی identity provider درکار ہوتا ہے۔
ذیل کی تمام معلومات ان projects کی اپنی documentation اور ان کی شائع کردہ configuration files سے لی گئی ہیں۔ یہ capability comparison ہے، benchmark نہیں۔ Version numbers اور requirements کے ساتھ تاریخ درج ہے، کیونکہ تینوں projects میں مسلسل تبدیلیاں آتی رہتی ہیں۔
اصل انتخاب structure ہے
BookStack آپ کے content کی ساخت طے کرتا ہے۔ ایک page کسی book کے اندر ہوتا ہے، ایک book میں chapters ہو سکتے ہیں، اور shelves، books کو گروپ کرتی ہیں۔ آپ پانچواں level نہیں بنا سکتے۔ یہی product کی بنیادی خصوصیت ہے: نئے writer کو معلوم ہوتا ہے کہ page کہاں رکھنا ہے، کیونکہ اس کے لیے صرف ایک جگہ موجود ہے۔ اس کی قیمت یہ ہے کہ جو content اس ساخت میں فٹ نہ آئے، اسے اسی میں زبردستی شامل کرنا پڑتا ہے۔
Wiki.js، disk پر موجود folders جیسا path tree استعمال کرتا ہے۔ ops/backup/restic پر موجود page آپ کی مقرر کردہ جگہ پر ہوتا ہے، اور آپ اس کی depth منتخب کرتے ہیں۔ کوئی چیز دو لوگوں کو ایک ہی subject کو دو مختلف branches کے تحت درج کرنے سے نہیں روکتی۔ اس لیے Wiki.js instance میں ایک ایسا شخص ہونا چاہیے جو tree کا ذمہ دار ہو۔
Outline میں collections استعمال ہوتی ہیں، جن کے اندر documents nested ہوتے ہیں۔ کسی document کو منتقل کرنے کے لیے mouse سے drag کرنا کافی ہے۔ تینوں میں یہ سب سے زیادہ flexible ہے، اس لیے اس میں structure کو آہستہ آہستہ بکھرنے دینا بھی سب سے آسان ہے۔
BookStack: سب سے آسان تنصیب
BookStack ایک PHP ایپلیکیشن ہے جو MySQL پر چلتی ہے۔ اکتوبر 2026 تک دستاویزی تقاضے PHP 8.2 یا اس کے بعد کا ورژن، اور MySQL 8.0 یا MariaDB 10.6 یا اس کے بعد کا ورژن ہیں۔ اگر آپ source سے تنصیب کریں تو Composer 2.2 یا اس کے بعد کا ورژن بھی درکار ہے۔ موجودہ release line 26.09 ہے، جو September 24, 2026 کو جاری ہوئی تھی، اور جدید ترین stable release v26.09.3 ہے، جو November 11, 2026 کی security release ہے۔ 26.09 سے APP_KEY کی value مقرر کرنا ضروری ہے، جس کا انتظام ذیل کے container steps پہلے ہی کرتے ہیں۔ BookStack نے October 21, 2026 کو PHP کی ایک critical security notice بھی جاری کی تھی: بنیادی PHP packages update کریں، یا patched image سے container کو pull کرکے دوبارہ بنائیں، کیونکہ صرف BookStack version سے یہ ثابت نہیں ہوتا کہ PHP patched ہے۔
یہ project اپنی درج فہرست Ubuntu LTS releases کے لیے installation scripts اور رہنمائی کی باضابطہ حمایت کرتا ہے۔ فی الحال یہ releases 22.04، 24.04 اور 26.04 ہیں۔ بعض اوقات دوسرے environments کے لیے unsupported guides اور scripts بھی جاری کیے جاتے ہیں۔ 24.04 script آپ کے لیے Apache، MySQL 8.0 اور PHP 8.3 install کرتی ہے۔ 26.04 پر ذیل کے commands میں installation-ubuntu-26.04.sh استعمال کریں؛ یہ MySQL 8.4 اور PHP 8.5 install کرتا ہے۔
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اس script کو چلانے سے پہلے اس میں موجود warning پڑھیں۔ دستاویزات کے مطابق یہ "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" ہے۔ 24.04 script موجودہ Apache configuration اور MySQL data کی جانچ کرتی ہے۔ اگر اسے دونوں میں سے کوئی چیز مل جائے تو installation سے پہلے عمل روک دیتی ہے۔ اس صورت میں containers استعمال کریں، یا Ubuntu 24.04 پر موجودہ LAMP stack کے اوپر BookStack دستی طور پر install کریں۔
Container route LinuxServer.io image استعمال کرتا ہے۔ یہ ان دو community container setups میں سے ایک ہے جنہیں BookStack documentation درج کرتی ہے۔ BookStack کو session encryption key درکار ہوتی ہے، اور اس کے بغیر یہ صفحات فراہم نہیں کرے گا، اس لیے پہلے key generate کریں۔
docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkeyچھپی ہوئی value کو APP_KEY میں copy کریں، پھر service لکھیں۔ اس service کو موجودہ MySQL یا MariaDB database بھی درکار ہے۔ DB_* کی values اس database کے مطابق مقرر کریں، کیونکہ یہ snippet database service نہیں بناتا۔
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 اس address سے مطابقت رکھنا چاہیے جو readers حقیقت میں type کرتے ہیں، جس میں scheme اور کوئی بھی port شامل ہو۔ اسے http://localhost پر مقرر کرکے site کو HTTPS پر serve کریں۔ بصورت دیگر generated links اور redirects غلط host کی طرف جائیں گے، اور readers کو ایسا login page نظر آئے گا جو دوبارہ اسی page پر واپس آتا رہے گا۔ اگر compose files آپ کے لیے نئی ہیں تو اس سے پہلے VPS پر Docker Compose کی بنیادی باتیں سے آغاز کریں۔
اسے start کریں اور یہ check کریں کہ application جواب دے رہی ہے، صرف یہ نہیں کہ container running ہے:
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:6875/login200 OK کا مطلب ہے کہ PHP application boot ہو چکی ہے اور database تک پہنچ گئی ہے۔ 500 کی تشخیص کے لیے application error log درکار ہے۔ By default BookStack اپنی errors کو container output کے بجائے ایک log file میں لکھتا ہے۔ وجہ دیکھنے کے لیے host پر ./config/log/bookstack/laravel.log کھولیں۔ docker compose logs bookstack container کے اپنے startup messages دکھاتا ہے، جن میں application error شامل نہ بھی ہو سکتی ہے۔
Wiki.js: ایک درخت، متعدد ایڈیٹرز
Wiki.js ایک Node.js ایپلیکیشن ہے۔ دستاویزی version 2 Docker setup اسے PostgreSQL کے ساتھ استعمال کرتا ہے، تاہم version 2 میں MySQL، MariaDB، MSSQL اور SQLite بھی قابل قبول ہیں۔ Version 3 کے لیے PostgreSQL 17 یا 18 درکار ہے۔ یہ project کے version 2 Docker صفحے کی compose file ہے:
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 دونوں کو تبدیل کریں، کیونکہ یہ ایک ہی credential ہیں اور sample value public ہے۔ tag کو جان بوجھ کر ghcr.io/requarks/wiki:2 پر مقرر کیا گیا ہے۔ documentation latest استعمال نہ کرنے کی تجویز دیتی ہے، کیونکہ نیا major version breaking changes لا سکتا ہے؛ version 3 یا اس کے بعد latest مزید assigned نہیں ہے۔
Version 3، November 1, 2026 کو stable ہوا۔ October 27, 2026 تک newest version 2 release 2.5.317 ہے۔ یہ October 23, 2026 کا bug-fix build ہے، جس میں latest Node security updates کے ساتھ image دوبارہ build کی گئی ہے۔ Version 2 releases اب الگ requarks/wiki-v2 repository سے publish ہوتی ہیں، اور :2 image tag اب بھی ان releases کو track کرتا ہے۔ November 16, 2026 کو جانچ کے مطابق، version 3 installation documentation میں ghcr.io/requarks/wiki:3، ghcr.io/requarks/wiki:3.4.0 اور ghcr.io/requarks/wiki:3.4 tags درج ہیں۔ Images کو major، major.minor اور major.minor.patch versions کے مطابق tag کیا گیا ہے۔ نئی installation کے لیے version 3 استعمال کریں؛ اوپر دی گئی compose مثال version 2 setup ہے۔ پچھلی release، 2.5.316، جو October 2, 2026 کو جاری ہوئی، نے بعد میں content کو version 3 میں منتقل کرنے کے لیے export utility شامل کی۔ موجودہ version 2 installation کے لیے الگ version 3 instance میں export اور import درکار ہے؛ image tag کو in-place تبدیل نہ کریں۔ Migration کے بعد permissions کا جائزہ لیں اور authentication اور storage کو دوبارہ configure کریں۔
پہلی بار load ہونے پر Wiki.js 2 browser کے اندر موجود setup کے ذریعے آپ کو لے جاتا ہے، جہاں administrator account بنایا جاتا ہے۔ جب تک آپ یہ setup مکمل نہیں کرتے، port تک پہنچنے والے ہر شخص کو یہ wizard نظر آئے گا۔ اس لیے firewall کھولنے سے پہلے service کو اپنے reverse proxy اور TLS (transport layer security) کے پیچھے رکھیں۔ اگر server پر اس service کے علاوہ بھی متعدد Docker apps چل رہی ہوں تو اپنے الگ hostname پر موجود wiki کو متعدد Docker apps کے سامنے Traefik کے پیچھے رکھنا فطری انتخاب ہے۔
Editor کا انتخاب ہی وہ وجہ ہے جس کی بنا پر لوگ Wiki.js منتخب کرتے ہیں۔ ایک version 2 instance میں Markdown pages، visual editor pages، raw HTML pages اور AsciiDoc pages ایک ساتھ رکھی جا سکتی ہیں۔ جب آپ پرانے content کو ایسے format میں import کر رہے ہوں جسے convert نہیں کرنا چاہتے، تو یہ سہولت مفید ہے۔ تاہم اس طرح ایک ہی wiki میں چار مختلف house styles بھی بن سکتی ہیں۔ اس لیے پہلے دن default editor طے کریں اور اس فیصلے کو تحریری طور پر محفوظ کریں۔
Outline: بہترین editor، لیکن سب سے زیادہ prerequisites
Outline عموماً اس وقت مراد ہوتا ہے جب لوگ ایسی چیز چاہتے ہیں جو commercial notes tool جیسا محسوس ہو۔ یہ Node.js application ہے، اور 16 November 2026 تک current release 1.13.0 ہے، جو 15 November 2026 کو جاری ہوئی۔ اس release میں Node 20 support ختم کر دی گئی ہے اور اس کی Docker image کو Node 26.13.1 پر update کیا گیا ہے، اس لیے پرانی installations کو update کریں۔ Source installations کے لیے اب Node 22.23.5، 24.22.3 یا 26.13.1 یا اس سے جدید version درکار ہے۔ اس کی sample environment file اس کی ضروریات دکھاتی ہے: DATABASE_URL کے ذریعے PostgreSQL، REDIS_URL کے ذریعے Redis، دو random secrets، اور عوامی طور پر قابل رسائی URL۔
openssl rand -hex 32
openssl rand -hex 32اس command کو دو بار چلائیں اور دونوں values محفوظ رکھیں۔ پہلی value SECRET_KEY اور دوسری UTILS_SECRET بنے گی۔ اس کے بعد 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/dataPGSSLMODE=disable صرف اس وقت درست ہے جب database اسی machine یا اسی Docker network پر موجود ہو۔ Network کے ذریعے حاصل کیے جانے والے database کے لیے اسے شامل نہ کریں، ورنہ connection غیر encrypted حالت میں منتقل ہوگا۔ Attachments کے لیے اب object storage لازمی نہیں: FILE_STORAGE=local uploads کو اوپر دی گئی directory میں لکھتا ہے۔ یہ directory ایسی volume ہونی چاہیے جس میں container لکھ سکے اور جسے آپ کے backups میں شامل کیا جاتا ہو۔ اگر یہ files S3 compatible bucket میں رکھنی ہوں تو AWS_* کی values کے ساتھ FILE_STORAGE=s3 set کریں۔
اب وہ حصہ آتا ہے جو اکثر لوگوں کے لیے حیران کن ہوتا ہے۔ Outline میں username اور password کے ذریعے built-in login موجود نہیں ہے۔ اس کی اپنی sample configuration کے مطابق third-party sign-in credentials درکار ہیں: "working installation کے لیے ان میں سے کم از کم ONE درکار ہے، ورنہ آپ کے پاس sign-in کا کوئی option نہیں ہوگا"۔ Documented providers میں Google، Slack، Microsoft Entra، Discord، اور OIDC_CLIENT_ID، OIDC_CLIENT_SECRET، OIDC_AUTH_URI، OIDC_TOKEN_URI اور OIDC_USERINFO_URI کے ذریعے کوئی بھی generic OpenID Connect (OIDC) server شامل ہے۔ Existing workspaces میں passkeys اور email links یا codes بھی enable کیے جا سکتے ہیں۔ Email login کے لیے SMTP درکار ہے، اور SSO provider سے linked accounts کے لیے یہ SSO کو bypass نہیں کرتا۔
اس لیے Outline کے documented production setup کی حقیقی لاگت Outline، PostgreSQL، Redis اور ایک identity provider پر مشتمل ہے۔ اگر آپ کی team پہلے ہی Google Workspace یا Microsoft Entra سے sign in کرتی ہے تو Outline بہت موزوں ہو جاتا ہے۔ اگر ایسا نہیں ہے تو آپ کو Keycloak یا Authentik جیسی سروس بھی self-host کرنی ہوگی، جسے patch اور backup کرنے کے لیے ایک اضافی service درکار ہوگی۔ Memory کا بجٹ اسی حساب سے بنائیں: Outline کی اپنی guidance کے مطابق ہر web process کے لیے تقریباً 512 MB درکار ہے، جسے WEB_CONCURRENCY set کرتا ہے، اور اس کے علاوہ database اور Redis کے لیے memory درکار ہے۔
ہر ایک یہ طے کرتا ہے کہ کون کیا پڑھ سکتا ہے
BookStack میں شروع سے مقامی email اور password accounts موجود ہوتے ہیں، اور متبادل کے طور پر LDAP، SAML2 اور OIDC بھی معاونت یافتہ ہیں۔ Permissions ہر role کے لیے set کی جاتی ہیں اور کسی ایک shelf، book، chapter یا page پر override کی جا سکتی ہیں۔ Book اور chapter کی permissions child content تک inherit ہوتی ہیں، جب تک انہیں override نہ کیا جائے؛ shelf کی permissions کو books پر واضح طور پر copy کرنا ضروری ہے۔
Wiki.js میں بھی مقامی accounts شامل ہوتے ہیں، اور admin area میں enable کی جانے والی strategies کی ایک طویل فہرست موجود ہے۔ اس کے page rules، path pattern کے مطابق access grant یا deny کرتے ہیں۔ یہ طاقتور بھی ہے اور غلطی سے configure کرنا بھی آسان ہے، کیونکہ ops/ سے شروع ہونے والے paths کی اجازت دینے والا rule بعد میں اس path کے تحت file کیے جانے والے ہر page پر لاگو ہوگا۔
Outline، SSO membership کے لیے آپ کے identity provider کا استعمال کرتا ہے، جبکہ Outline کے اندر access کو collection، document اور group کے مطابق control کیا جاتا ہے۔ identity provider سے remove کیے گئے users، اگلی بار Outline load کرنے پر log out ہو جاتے ہیں؛ موجودہ sessions کو فوراً ختم کرنے کے لیے انہیں Outline میں suspend کریں۔
ہر ایک میں search کیسے کام کرتی ہے
Search وہ مرحلہ ہے جہاں wiki یا تو اپنی افادیت ثابت کرتی ہے یا بھولی ہوئی files کے folder میں تبدیل ہو جاتی ہے۔
BookStack database میں search کرتا ہے اور readers کو ایسی query language فراہم کرتا ہے جسے وہ ایک منٹ میں سیکھ سکتے ہیں۔ کسی phrase کو quotes میں لکھنے سے، جیسا کہ "london meeting" میں، اسی exact string کی ضرورت ہوتی ہے۔ Square brackets tags میں search کرتے ہیں: [location=london] tag name، value یا دونوں کے مطابق match کرتا ہے، اور اس میں !=، >= اور like سمیت comparisons شامل ہیں۔ Curly braces metadata کے مطابق filter کرتے ہیں، جیسا کہ {created_after:2016-12-30} میں ہے۔ کسی بھی exact، tag یا filter term کے شروع میں - لگا کر اسے negate کیا جا سکتا ہے۔ BookStack ایک query میں ہر قسم کے terms کی تعداد محدود رکھتا ہے، اس لیے بہت لمبی query چلانے کے بجائے trim کر دی جاتی ہے۔
Wiki.js 2 میں search ایک pluggable module ہے۔ Documented engines میں basic database engine، PostgreSQL engine، Elasticsearch، Algolia، AWS CloudSearch اور Azure Search شامل ہیں۔ Basic engine page bodies کے بجائے titles، descriptions اور paths میں match کرتا ہے۔ اگر آپ PostgreSQL چلا رہے ہیں تو admin area میں PostgreSQL engine منتخب کریں، کیونکہ یہ simple matching کے بجائے database کا اپنا full text index استعمال کرتا ہے۔ Elasticsearch ایسی بڑی wiki کے لیے رکھیں جہاں آپ دوسری search service چلانے اور اس پر patches لگانے کی ذمہ داری قبول کرتے ہوں۔
Outline PostgreSQL full text indexes میں search کرتا ہے۔ اس کی built-in keyword search کے لیے کسی الگ search service کی ضرورت نہیں ہوتی۔ چند ہزار documents والی team wiki کے لیے، ان تینوں میں اس کے انتظامی کام سب سے کم ہیں۔
آپ کے لیے کون سا موزوں ہے
اگر آپ چاہتے ہیں کہ wiki آج ہی چل جائے اور structure کے بجائے content پر بحث کرنا پسند کریں، تو BookStack منتخب کریں۔ اس میں کم سے کم اجزا شامل ہیں: ایک PHP application اور ایک MySQL database۔ یہ internal runbooks اور customer documentation کے لیے موزوں ہے، اور ان ٹیموں کے لیے بھی جہاں زیادہ تر writers engineers نہیں ہیں۔ ان تینوں میں اس کا backup لینا بھی سب سے آسان ہے، کیونکہ state ایک database dump، uploaded files اور .env configuration پر مشتمل ہوتی ہے، جس میں APP_KEY بھی شامل ہے۔
اگر آپ کو ایسا مخصوص editor یا authentication strategy درکار ہے جو باقی options پیش نہیں کرتے، یا آپ بڑی مقدار میں موجودہ Markdown یا AsciiDoc درآمد کر رہے ہیں اور path structure محفوظ رکھنا چاہتے ہیں، تو Wiki.js منتخب کریں۔ تسلیم کریں کہ آپ ایک زیادہ بھاری stack چلا رہے ہیں، اور major version tag کو pin کریں۔
اگر writing quality سب سے زیادہ اہم ہے، wiki عوام کے بجائے کسی team کے لیے ہے، اور آپ کے پاس پہلے سے identity provider موجود ہے، تو Outline منتخب کریں۔ اس setup کے عوض یہ ایسا editor فراہم کرتا ہے جسے لوگ واقعی استعمال کرنا پسند کرتے ہیں۔ اسے اپنی پہلی self-hosted application کے طور پر منتخب نہ کریں۔
اگر ان تینوں میں سے کوئی بھی موزوں نہیں، تو مسئلہ عموماً content type کا ہوتا ہے۔ Scanned invoices اور contracts کو wiki کے بجائے Paperless-ngx جیسے document management system میں رکھنا چاہیے، اور انہیں wiki میں زبردستی شامل کرنا ہی وجہ ہے کہ بہت سی wikis آخرکار abandoned ہو جاتی ہیں۔ دوسری عام عدم مطابقت یہ ہے کہ آپ wiki کے بجائے workspace چاہتے ہیں، جہاں ایک ہی canvas پر documents، tables اور whiteboard موجود ہوں۔ اس صورت میں self-hosted AFFiNE workspace اوپر دیے گئے تینوں options سے زیادہ موزوں ہے۔ اپنے server پر مزید کون سی چیزیں جگہ بنانے کے قابل ہیں، اس کے وسیع جائزے کے لیے 2026 کی self-hosting shortlist دیکھیں۔
وسائل اور بیک اپ
تینوں کو ایک چھوٹے VPS پر چلایا جا سکتا ہے، لیکن ہر ایک کے لیے عملی کم از کم وسائل مختلف ہیں کیونکہ ہر ایپ کے پیچھے موجود اجزا مختلف ہیں۔ BookStack ایک application process اور MySQL پر مشتمل ہے۔ Wiki.js ایک Node process اور PostgreSQL پر مشتمل ہے۔ Outline ایک Node process، PostgreSQL اور Redis پر مشتمل ہے، اور عموماً اس کے ساتھ identity provider بھی ہوتا ہے۔ اسی لیے Outline کے لیے زیادہ memory مختص کریں۔
Database اور uploads کا ایک ساتھ بیک اپ لیں، اور اس بیک اپ پر انحصار کرنے سے پہلے دونوں کو ایک عارضی instance میں کم از کم ایک بار restore کریں۔ ایسا wiki backup جسے کسی نے restore نہ کیا ہو، صرف ایک اندازہ ہے۔ BookStack کے لیے اس کا مطلب mysqldump اور /config volume ہے۔ Wiki.js اور Outline کے لیے اس کا مطلب pg_dump اور data volume ہے، جبکہ Outline کے لیے FILE_STORAGE_LOCAL_ROOT_DIR میں موجود data بھی شامل کریں۔
FAQ
انسٹال کرنے کے لیے سب سے آسان self-hosted wiki کون سا ہے؟
BookStack۔ یہ MySQL database کے ساتھ ایک single PHP application ہے، اور project Ubuntu 24.04 کے لیے installation script فراہم کرتا ہے، جو ایک ہی run میں Apache، MySQL 8.0 اور PHP 8.3 ترتیب دے دیتی ہے۔ Container image کو ایک APP_KEY، ایک APP_URL اور موجودہ database کی credentials درکار ہوتی ہیں۔ Wiki.js میں Node runtime اور PostgreSQL server بھی شامل ہوتے ہیں، جبکہ Outline کے documented initial setup میں Redis اور بیرونی identity provider بھی درکار ہوتا ہے۔
کیا میں Google یا کسی دوسرے SSO provider کے بغیر Outline استعمال کر سکتا ہوں؟
اس کے documented production setup میں initial workspace بنانے کے لیے ایک provider درکار ہوتا ہے۔ Outline میں local username اور password login موجود نہیں ہے۔ اس کی sample configuration کے مطابق کم از کم ایک third party sign-in provider ضروری ہے، ورنہ sign-in کا کوئی option دستیاب نہیں ہوگا۔ آپ Google، Slack، Microsoft Entra، Discord، یا کسی generic OpenID Connect server، مثلاً self-hosted Keycloak یا Authentik، کو استعمال کر سکتے ہیں۔ موجودہ workspaces میں passkeys یا email links اور codes فعال کیے جا سکتے ہیں، لیکن email login کے لیے SMTP درکار ہے؛ SSO سے linked accounts اب بھی اسی provider کو استعمال کرتے ہیں۔
مجھے Wiki.js 3 انسٹال کرنا چاہیے یا Wiki.js 2؟
نئی installation کے لیے Version 3 انسٹال کریں۔ یہ November 1, 2026 کو stable ہوئی، اور اس کی installation documentation اب ghcr.io/requarks/wiki:3، ghcr.io/requarks/wiki:3.4.0 اور ghcr.io/requarks/wiki:3.4 tags درج کرتی ہے۔ Major version tag کو pin کریں، نہ کہ latest کو، کیونکہ Version 3 یا اس کے بعد کے لیے یہ tag اب assign نہیں کیا جاتا۔ اوپر دیا گیا compose example اب بھی version 2 پر pinned ہے۔ موجودہ version 2 installations میں migration package export کر کے اسے الگ version 3 instance میں import کرنا ضروری ہے؛ صرف image tag تبدیل کرنا supported upgrade نہیں ہے۔
بہترین search کس میں ہے؟
ہر ایک مختلف پہلو سے مضبوط ہے۔ BookStack readers کو exact phrases کے ساتھ query language، [location=london] جیسے tag filters، اور {created_after:2016-12-30} جیسے metadata filters فراہم کرتا ہے، اور ان میں سے کسی بھی term کو شروع میں - لگا کر خارج کیا جا سکتا ہے۔ Outline کی built-in keyword search کے لیے الگ search service درکار نہیں ہوتی۔ Wiki.js 2 سب سے زیادہ tunable ہے، کیونکہ آپ engine منتخب کرتے ہیں، اور PostgreSQL engine page bodies میں بھی search کرتا ہے، جو basic engine نہیں کرتا۔
کیا میں بعد میں اپنا content ایک platform سے دوسرے platform میں منتقل کر سکتا ہوں؟
جزوی طور پر، لیکن manual work کی توقع رکھیں۔ تینوں Markdown export کرتے ہیں، مگر BookStack کا built-in import صرف اس کے Portable ZIP format کو قبول کرتا ہے؛ اس لیے صرف Markdown کو BookStack میں براہِ راست import نہیں کیا جا سکتا۔ Structure بھی درست طور پر منتقل نہیں ہوتی: BookStack کی books اور chapters کا Outline کی nested documents میں کوئی equivalent نہیں، اور Wiki.js کے paths، BookStack کی fixed hierarchy سے مطابقت نہیں رکھتے۔ Attachments، permissions اور page history کے ضائع ہونے کا امکان سب سے زیادہ ہوتا ہے، اس لیے migration کا فیصلہ کرنے سے پہلے ایک sample export کر کے ان چیزوں کی جانچ کریں۔