Language: ur

Karakeep: VPS پر ذاتی bookmark archive انسٹال کریں

لنک محفوظ کرنا آسان ہے، لیکن چھ ماہ بعد اسے تلاش کرنا مشکل ہو سکتا ہے—خاص طور پر جب page بدل جائے، غائب ہو جائے یا سینکڑوں bookmarks میں دب جائے۔

Karakeep URL کے ساتھ page content، preview، notes، images اور PDFs بھی محفوظ کرتا ہے۔ Archive کو text سے search، items کو lists میں منظم اور AI کے ذریعے خودکار tag کیا جا سکتا ہے۔ یہ آپ کے اپنے VPS پر چلتا ہے اور language model کا استعمال اختیاری ہے۔

اس مضمون میں Karakeep کی خصوصیات، server requirements اور Ubuntu 24.04 پر Docker Compose، HTTPS اور backups کے ساتھ installation دیکھیں گے۔

Karakeep سات مراحل میں

1. Linux VPS بنائیں اور keep.example.com جیسی subdomain کو اس کی طرف point کریں۔
2. Docker Engine اور Docker Compose انسٹال کریں۔
3. سرکاری docker-compose.yml download کریں۔
4. secrets بنائیں اور Karakeep، Chrome اور Meilisearch شروع کریں۔
5. internal port 3000 بند کرکے Caddy کے ذریعے HTTPS فعال کریں۔
6. پہلا account بنائیں اور پھر open registration بند کریں۔
7. browser extension یا mobile app انسٹال کرکے bookmarks import کریں۔

سروس شروع کرنے کے لیے AI key ضروری نہیں۔ اس کے بغیر page saving، lists، notes، OCR اور full-text search کام کرتے رہیں گے؛ صرف automatic tags اور summaries نہیں بنیں گی۔

Karakeep کیا ہے؟

Karakeep links، text notes، images اور PDFs کو ایک library میں محفوظ کرنے والی open-source، self-hosted application ہے۔ Project کا سابقہ نام Hoarder تھا۔

نام عربی لفظ karakeeb سے آیا ہے، جو بکھری ہوئی ایسی چیزوں کے لیے استعمال ہوتا ہے جن میں پوشیدہ value ہو۔ Bookmark collection بھی اسی طرح ہے: مفید مواد بہت ہوتا ہے، مگر صحیح item تلاش کرنا مشکل رہتا ہے۔

Link شامل کرنے کے بعد Karakeep اس کا title اور description حاصل کرتا، readable text نکالتا، preview بناتا اور ضرورت پر page کی local copy محفوظ کرتا ہے۔

Feature	Browser bookmarks	Karakeep
کیا محفوظ ہوتا ہے	URL اور title	Text، preview، notes اور attachments
Search	Title اور address سے	Content، tags اور notes سے
Page غائب ہو جائے	Broken URL باقی رہتا ہے	Text، screenshot یا مکمل archive باقی رہتا ہے
Organization	Folders	Tags، manual lists اور smart lists
Access	Browser میں	Web، extensions، iOS اور Android
Server	Browser profile یا cloud service	آپ کا VPS یا home server

Karakeep کی اہم خصوصیات

Links، notes، images اور PDFs

ہر item link، text note یا uploaded file ہو سکتا ہے۔ OCR تصاویر اور PDFs سے text نکالتا ہے، اس لیے وہ بھی searchable بن جاتے ہیں۔ Item کے ساتھ note، quotation یا اضافی file attach کی جا سکتی ہے۔

Content search

Meilisearch محفوظ text، notes اور metadata کو index کرتا ہے۔ Exact title یاد رکھنا ضروری نہیں؛ کوئی phrase یا topic کافی ہے۔ Embeddings configure ہونے پر meaning کے مطابق semantic search بھی ملتی ہے۔

Smart اور collaborative lists

ایک item کئی lists میں شامل ہو سکتا ہے، duplicate نہیں بنتا۔ List private رہ سکتی ہے، link کے ذریعے share ہو سکتی ہے یا دوسرے users کے ساتھ edit کی جا سکتی ہے۔

Smart list ایک saved search query ہے جو خود update ہوتی رہتی ہے۔ مثال کے طور پر یہ پچھلے ہفتے شامل کیے گئے تمام ai tag والے items دکھا سکتی ہے۔

Page archiving

Default طور پر Karakeep extracted text اور page کے visible حصے کا screenshot محفوظ کرتا ہے۔ Full-page snapshot، PDF یا self-contained HTML archive بھی فعال کیا جا سکتا ہے۔ اس سے dead links کے باوجود library محفوظ رہتی ہے، مگر disk usage بڑھتا ہے۔

Authentication کے پیچھے pages، advanced anti-bot protection اور interactive applications مکمل طور پر save نہ ہوں۔ اہم مواد کو الگ PDF یا file کے طور پر upload کریں۔

اختیاری AI tagging

Karakeep external OpenAI-compatible API یا local Ollama model سے tags اور مختصر summaries بنا سکتا ہے۔ AI کے بغیر بھی یہ مکمل bookmark manager ہے۔

Local model مواد کو external provider کے پاس نہیں بھیجتا، لیکن اس کے لیے زیادہ RAM چاہیے۔ اسی لیے Ollama کو اکثر main Karakeep instance سے الگ host کیا جاتا ہے۔

Karakeep کے لیے server requirements

Official documentation CPU اور RAM کا fixed minimum نہیں بتاتی۔ مکمل installation میں تین containers شامل ہوتے ہیں:

• Karakeep database محفوظ کرکے interface فراہم کرتا ہے؛
• headless Chrome pages کھولتا، JavaScript چلاتا اور screenshots لیتا ہے؛
• Meilisearch library کو index کرتا ہے۔

ایک user، local LLM کے بغیر عملی configuration:

• 2 vCPU؛
• 2 GB RAM؛
• 20–30 GB SSD یا NVMe؛
• Ubuntu 24.04 LTS؛
• public IP address اور domain۔

کئی users، بڑے import، RSS feeds اور PDFs کے لیے 4 GB RAM زیادہ مناسب ہے۔ Archiving mode کے مطابق disk کی ضرورت بدلتی ہے: text کم جگہ لیتا ہے، جبکہ مکمل screenshots، PDFs اور videos library کو تیزی سے بڑھا سکتے ہیں۔

VPS پر Karakeep کیسے انسٹال کریں

اس مثال میں Ubuntu 24.04 اور keep.example.com subdomain استعمال کی گئی ہے۔

1. DNS اور firewall configure کریں

Server IP کی طرف اشارہ کرنے والا A DNS record بنائیں، پھر SSH سے connect کریں:

ssh root@SERVER_IP
apt update && apt upgrade -y

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw --force enable

نئے connection کی تصدیق سے پہلے موجودہ SSH session بند نہ کریں۔

2. Docker انسٹال کریں

apt install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

apt update
apt install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin
docker compose version

3. Karakeep configuration download کریں

mkdir -p /opt/karakeep
cd /opt/karakeep

curl -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml

دو الگ secrets بنائیں:

openssl rand -base64 36
openssl rand -base64 36 | tr -dc 'A-Za-z0-9'

/opt/karakeep/.env بنائیں:

KARAKEEP_VERSION=release
NEXTAUTH_SECRET=INSERT_THE_FIRST_SECRET
MEILI_MASTER_KEY=INSERT_THE_SECOND_SECRET
NEXTAUTH_URL=https://keep.example.com
DISABLE_SIGNUPS=false
DB_WAL_MODE=true
RATE_LIMITING_ENABLED=true

.env public نہ کریں: پہلا secret authentication tokens sign کرتا ہے اور دوسرا Meilisearch کو protect کرتا ہے۔

4. Internal port بند کریں

docker-compose.yml میں:

ports:
  - 3000:3000

کو اس سے replace کریں:

ports:
  - 127.0.0.1:3000:3000

اس طرح port 3000 internet سے براہ راست accessible نہیں ہوگا۔

5. Containers شروع کریں

cd /opt/karakeep
docker compose up -d
docker compose ps

web، chrome اور meilisearch services running ہونی چاہییں۔ Logs دیکھنے کے لیے:

docker compose logs --tail=200

6. HTTPS فعال کریں

apt install -y caddy

cat > /etc/caddy/Caddyfile <<'EOF'
keep.example.com {
    reverse_proxy 127.0.0.1:3000
}
EOF

caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy

DNS درست ہو اور ports 80 اور 443 کھلے ہوں تو Caddy خود TLS certificate حاصل کرلے گا۔ پھر https://keep.example.com کھولیں۔

7. Administrator بنائیں اور registration بند کریں

پہلا registered user خود بخود administrator بنتا ہے۔ Account بنانے کے بعد .env میں یہ setting کریں:

DISABLE_SIGNUPS=true

تبدیلی apply کریں:

cd /opt/karakeep
docker compose up -d

Administrator دوسرے accounts پھر بھی manually بنا سکے گا۔

Data، extensions اور mobile apps import کرنا

Karakeep Chrome، Firefox اور Safari extensions، نیز iOS اور Android apps فراہم کرتا ہے۔ فون پر system Share menu سے link archive میں بھیجا جا سکتا ہے۔

موجودہ bookmarks standard browser HTML file، Pocket، Omnivore اور دیگر supported services سے import کیے جا سکتے ہیں۔ بڑا archive batches میں شامل کریں، کیونکہ server کو pages کھولنے، text نکالنے، screenshots بنانے اور search index بنانے ہوتے ہیں۔

AI اور full-page archiving کیسے فعال کریں

OpenAI کے لیے .env میں شامل کریں:

OPENAI_API_KEY=YOUR_API_KEY

دوسری OpenAI-compatible service کو OPENAI_BASE_URL درکار ہو سکتا ہے۔ Local model کے لیے OLLAMA_BASE_URL میں container سے accessible address دیں۔

Page کی مکمل local copy الگ سے فعال کریں:

CRAWLER_FULL_PAGE_ARCHIVE=true

CRAWLER_FULL_PAGE_SCREENSHOT=true اور CRAWLER_STORE_PDF=true بھی دستیاب ہیں۔ ضرورت نہ ہو تو ہر mode فعال نہ کریں، کیونکہ disk usage کافی بڑھ جائے گا۔ .env بدلنے کے بعد docker compose up -d چلائیں۔

Security، updates اور backups

Karakeep crawler آپ کے server کے network سے user-saved addresses کھولتا ہے۔ Registration کھلا نہ چھوڑیں اور صرف trusted لوگوں کو access دیں۔ Basic SSRF protection موجود ہے، لیکن public service کے لیے browser کو isolate یا restricted proxy کے ذریعے route کرنا بہتر ہے۔

HTTPS، strong passwords بھی استعمال کریں، port 3000 expose نہ کریں اور containers باقاعدگی سے update کریں:

cd /opt/karakeep
docker compose up --pull always -d

Main database اور محفوظ materials Docker volume data میں رکھے جاتے ہیں۔ Copy سے پہلے containers stop کریں:

mkdir -p /var/backups/karakeep
cd /opt/karakeep
docker compose stop

docker run --rm \
  -v karakeep_data:/source:ro \
  -v /var/backups/karakeep:/backup \
  alpine sh -c 'tar czf /backup/data-$(date +%F).tar.gz -C /source .'

cp .env docker-compose.yml /var/backups/karakeep/
docker compose start

نام karakeep_data فرض کرتا ہے کہ project directory /opt/karakeep ہے؛ اسے docker volume ls سے verify کریں۔ Meilisearch index دوبارہ بنایا جا سکتا ہے، لیکن بڑی library کے لیے karakeep_meilisearch volume کا backup بھی مفید ہے۔

Archive کو /var/backups/karakeep سے دوسرے server، NAS یا object storage پر بھیجیں۔ اسی VPS پر موجود copy disk failure یا virtual machine delete ہونے سے محفوظ نہیں کرتی۔

Karakeep کے لیے VPS کا انتخاب

Ollama کے بغیر personal library کے لیے 2 vCPU، 2 GB RAM اور 20–30 GB NVMe والا Linux VPS مناسب ہے۔ بڑے import، کئی users اور full archiving کے لیے 4 GB RAM اور زیادہ disk منتخب کریں۔

Karakeep tropic.host کے VPS پر چل سکتا ہے: مستقل IP domain configuration آسان بناتا ہے، جبکہ NVMe SQLite، search index اور بہت سی چھوٹی files کے لیے مفید ہے۔ Archive بڑھنے کے ساتھ resources بڑھائے جا سکتے ہیں۔

Local Ollama کے resources الگ plan کریں، کیونکہ چھوٹے language model کو بھی main Karakeep stack سے زیادہ memory درکار ہو سکتی ہے۔

نتیجہ

Karakeep بکھرے links کو searchable personal library میں بدل دیتا ہے۔ یہ pages، notes، images اور PDFs محفوظ کرتا ہے اور OCR، lists، extensions، mobile apps اور اختیاری AI tagging support کرتا ہے۔

شروع کرنے کے لیے چھوٹا VPS، Docker Compose، domain اور HTTPS کافی ہیں۔ Installation کے بعد registration بند کریں، disk usage monitor کریں اور external backup رکھیں۔

FAQ

کیا Karakeep مفت ہے؟

Self-hosted version open source ہے اور لازمی subscription نہیں مانگتا۔ VPS، domain، backup storage اور ضرورت پر external AI API کے اخراجات الگ ہوں گے۔

کیا Karakeep کے لیے API key ضروری ہے؟

نہیں۔ Materials save اور index کرنا، lists، notes، OCR اور full-text search AI کے بغیر کام کرتے ہیں۔ Automatic tags، summaries اور متعلقہ features کے لیے model چاہیے۔

Karakeep کو کتنی RAM درکار ہے؟

Ollama کے بغیر ایک user کے لیے 2 GB RAM سے آغاز کریں۔ بڑے imports، کئی users اور active processing کے لیے 4 GB زیادہ مناسب ہے۔

کیا browser یا Pocket سے bookmarks import ہو سکتے ہیں؟

ہاں۔ Karakeep standard browser bookmark HTML file، Pocket، Omnivore اور کئی دوسرے formats support کرتا ہے۔ Import کے بعد صفحات process ہوکر search میں شامل ہو جاتے ہیں۔

اگر اصل website غائب ہو جائے تو کیا article دستیاب رہے گا؟

Karakeep extracted text اور screenshot محفوظ کرتا ہے، اور full archiving فعال ہونے پر local copy یا PDF بھی بنا سکتا ہے۔ Authentication کے پیچھے pages اور پیچیدہ web applications صرف جزوی طور پر محفوظ ہو سکتی ہیں۔