Docker کے ساتھ سیلف ہوسٹ

کمیونٹی ایڈیشن (AGPL-3.0) ایک مکمل چیٹ پلیٹ فارم ہے جسے آپ ہر اُس جگہ چلا سکتے ہیں جہاں Docker چلتا ہے۔ انٹرپرائز ایڈ آنز ایک علیحدہ پرائیویٹ ریپو میں موجود ہیں جو لائسنس کی سے محفوظ ہیں۔

پیشگی شرائط

• Docker 24+ اور docker compose v2
• کم از کم 2 vCPU، 4 GB RAM (8 GB تجویز کردہ)
• آپ کے سرور کی طرف اشارہ کرنے والا ایک ڈومین (TLS کے لیے)

انسٹال

git clone https://github.com/singlink/singlink
cd singlink
cp .env.example .env
# edit .env: AUTH_SECRET, DATABASE_URL, REDIS_URL, S3_*

docker compose up -d

بطورِ ڈیفالٹ یہ Postgres (pgvector کے ساتھ)، Redis، MinIO، web، ws اور worker کو شروع کرتا ہے۔ یہ تصدیق کرنے کے لیے کہ تمام پانچوں کنٹینرز درست حالت میں ہیں docker compose ps چلائیں۔

ابتدائی سیٹ اپ

docker compose exec web pnpm db:migrate deploy
docker compose exec web pnpm db:seed     # optional demo tenant

ریورس پراکسی

سامنے nginx (یا Caddy) رکھیں۔ /api/* اور /v1/ws دونوں کو cookie شیئر کرنے کے لیے ایک ہی اوریجن پر پہنچنا ضروری ہے۔ WS اینڈ پوائنٹ کو upgrade ہیڈرز درکار ہیں:

location /v1/ws {
  proxy_pass http://ws:3001;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
  proxy_read_timeout 86400s;
}

بیک اپس

• Postgres — روزانہ pg_dump؛ اس میں S3 منسلکات کے علاوہ ہر چیز شامل ہے
• S3 / MinIO — bucket ورژننگ استعمال کریں یا کسی دوسرے ریجن میں rclone syncکریں
• Redis — عارضی (قطاریں)، بیک اپ کی ضرورت نہیں؛ جابز ری اسٹارٹ پر دوبارہ چلتی ہیں

اپ گریڈز

git fetch && git checkout v0.x.y
docker compose pull
docker compose up -d
docker compose exec web pnpm db:migrate deploy

مائیگریشنز فارورڈ کمپیٹیبل ہیں؛ ہم بڑے ورژن میں اضافے کے بغیر کسی چلتے ہوئے انسٹینس کو کسی توڑنے والے schema تبدیلی سے خراب نہیں کریں گے۔