BookStack کے لیے VPS: خود ہوسٹ کی گئی ٹیم وکی

ٹیم کی دستاویزات عموماً دو میں سے ایک طریقے سے مرتی ہیں: ایسے چیٹ تھریڈز میں بکھری ہوئی جن میں کوئی تلاش نہیں کر سکتا، یا ایسی بھدی وکی میں دفن جسے کوئی اپ ڈیٹ نہیں کرتا۔ BookStack وہ نایاب خود ہوسٹ کی گئی وکی ہے جسے لوگ واقعی استعمال کرتے ہیں۔ مواد شیلفوں، کتابوں، ابواب اور صفحات میں ہوتا ہے — ایسا ڈھانچہ جو ہر کوئی تربیت کے بغیر سمجھ لیتا ہے۔ اور اسے تقریباً کوئی سرور نہیں چاہیے۔

BookStack کیوں

• واضح ڈھانچہ۔ صفحات کے سپاٹ ڈھیر کے بجائے کتابیں اور ابواب۔
• ایسی ایڈیٹنگ جو کسی کو نہ ڈرائے۔ ڈیفالٹ طور پر WYSIWYG ایڈیٹر، پسند کرنے والوں کے لیے Markdown۔
• حقیقی اجازتیں۔ ہر شیلف، کتاب یا صفحے کے لیے کردار — HR کی دستاویزات ٹھیکیداروں سے دور رہتی ہیں۔
• کمپنی لاگ ان۔ LDAP، SAML2 اور OpenID Connect پہلے سے موجود ہیں۔
• آپ کا ڈیٹا۔ سب کچھ ایک MariaDB ڈیٹابیس اور آپ کے سرور کے ایک فولڈر میں ہے۔

یہ ہر کام کا درست ٹول نہیں۔ ڈیولپرز کی دستاویزات جنہیں کوڈ کے ساتھ بدلنا ہو، ان کی جگہ ریپوزٹری ہے، وکی نہیں۔

اسے کیا چاہیے

BookStack ہلکا ہے۔ زیادہ تر ٹیموں کے لیے Micro-IP — 1 vCPU، 2 GB، $10 ماہانہ — کافی سے زیادہ ہے۔ مخصوص IP ہی ساتھیوں کو آپ کے ڈومین پر HTTPS کے ذریعے پہنچنے دیتا ہے۔ ڈسک اپ لوڈ کیے گئے اسکرین شاٹس اور PDFs سے بڑھتی ہے، صفحات کی تعداد سے نہیں۔

Docker Compose سے انسٹالیشن

ہم LinuxServer.io کی مقبول امیجز استعمال کریں گے۔ پہلے ایپلیکیشن کلید بنائیں:

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

جو base64:... قدر یہ پرنٹ کرے اسے کاپی کریں۔ پھر docker-compose.yml بنائیں:

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=https://wiki.example.com
      - APP_KEY=base64:paste-your-key-here
      - DB_HOST=db
      - DB_PORT=3306
      - DB_DATABASE=bookstack
      - DB_USERNAME=bookstack
      - DB_PASSWORD=change-me
    volumes:
      - ./bookstack:/config
    ports:
      - 127.0.0.1:6875:80
    depends_on:
      - db
    restart: unless-stopped
  db:
    image: lscr.io/linuxserver/mariadb:latest
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=change-me-too
      - MYSQL_DATABASE=bookstack
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=change-me
    volumes:
      - ./db:/config
    restart: unless-stopped

docker compose up -d
docker compose logs -f bookstack

APP_URL کو اسی ایڈریس سے میل کھانا چاہیے جو لوگ استعمال کریں گے، https:// سمیت۔ غلط ہوا تو تصاویر اور لنکس عجیب طریقوں سے ٹوٹتے ہیں۔ Compose کے بارے میں مزید ہماری اسٹیک ڈیپلائے گائیڈ میں ہے۔

HTTPS اور پہلا لاگ ان

ایک سب ڈومین کو سرور سے جوڑیں (کیسے)، 127.0.0.1:6875 کے آگے nginx رکھیں اور certbot سے سرٹیفکیٹ شامل کریں — reverse proxy گائیڈ قدم بہ قدم رہنمائی کرتی ہے۔

پھر ڈیفالٹ اکاؤنٹ سے لاگ ان کریں: admin@admin.com / password۔ لنک شیئر کرنے سے پہلے ای میل اور پاس ورڈ فوراً بدلیں۔ باقی سب کو اپنا اکاؤنٹ ملتا ہے یا وہ آپ کے شناختی فراہم کنندہ سے لاگ ان کرتے ہیں۔

بیک اپ

دو چیزوں کی حفاظت کرنی ہے: ڈیٹابیس اور ./bookstack کے اندر اپ لوڈز۔ اس طرح کی رات کی جاب ڈیٹابیس کو کور کرتی ہے:

docker compose exec -T db mysqldump -u bookstack -pchange-me bookstack > /var/backups/bookstack.sql

پھر /var/backups اور compose فولڈر کا سرور سے باہر بیک اپ لیں — ہماری restic گائیڈ بالکل یہی کرتی ہے۔ Managed Backups اس کے اوپر پورے سرور کے روزانہ ریسٹور پوائنٹس شامل کرتے ہیں۔

دیکھ بھال

اپ ڈیٹ کرنا docker compose pull && docker compose up -d ہے۔ BookStack شروع ہوتے وقت ڈیٹابیس مائیگریشنز چلاتا ہے۔ بڑے ورژنز سے پہلے ریلیز نوٹس پڑھیں؛ یہ مختصر اور واضح ہیں۔

اگر آپ کی ٹیم ٹکٹس اور کوڈ کے لیے بھی جگہ چاہتی ہے تو خود ہوسٹ کیا گیا Git سرور اسی قسم کے پلان پر اس کے ساتھ اچھا بیٹھتا ہے۔