Self-hosted Git server: Forgejo، Gitea یا cgit؟
اپنے self-hosted Git server کا انتخاب RAM کے مطابق کریں: SSH bare repos، cgit، Forgejo، Gitea اور GitLab میں دیکھیں کہ 1 GB VPS پر کیا چلے گا۔
آپ کو کون سا self-hosted Git server چلانا چاہیے
self-hosted Git server کوئی ایک product نہیں ہے، اور آپ کے VPS کی RAM (random access memory) یہ طے کرتی ہے کہ آپ اس کا کون سا ورژن چلا سکتے ہیں۔ Git کو اپنے کسی daemon کی ضرورت نہیں ہوتی: bare repository اور SSH (secure shell) account پہلے ہی اس سب سے چھوٹے سرور پر کام کرنے والا server فراہم کرتے ہیں جسے آپ کرائے پر لے سکتے ہیں۔ اس حد سے آگے ہر مرحلہ ایک web application ہے جسے آپ اس کے ساتھ چلانے کا انتخاب کرتے ہیں، اور ہر اگلے مرحلے کے لیے اتنی memory درکار ہوتی ہے جو ایک چھوٹے VPS میں موجود نہ بھی ہو سکتی ہے۔ اگر آپ اب بھی اس بارے میں غیر یقینی کا شکار ہیں کہ Git کہاں ختم ہوتا ہے اور GitHub کہاں سے شروع ہوتا ہے، تو Git، GitHub اور اپنے Git server میں کیا فرق ہے کسی tier کا انتخاب کرنے سے پہلے یہ تقسیم واضح کرتا ہے۔
چار مراحل ہیں۔ SSH کے ذریعے bare repository، جس میں پہلے سے listening کسی چیز کے علاوہ کوئی اور چیز listening نہیں کرتی۔ cgit، ایک تیز read-only web view جس کے لیے database نہیں ہوتا۔ Forgejo یا Gitea، ایک مکمل forge جس میں چند سو megabytes میں accounts، issues اور pull requests شامل ہوتے ہیں۔ GitLab، جس کے لیے دیگر options سے کئی گنا بڑا server درکار ہوتا ہے۔
اپنی ضرورت کے کام کے مطابق فیصلہ کریں، پھر memory figure کا موازنہ اس plan سے کریں جس کی ادائیگی آپ کر رہے ہیں۔
ہر اختیار کو درکار حقیقی RAM
ان میں سے صرف دو projects hardware figure شائع کرتے ہیں۔ شائع کردہ figure کو حتمی ضمانت کے بجائے کم از کم حد سمجھیں، اور اپنی instance کے چلنے کے بعد systemd-cgtop یا ps -o rss= -C forgejo سے اس کی پیمائش کریں۔
اس چارٹ کے پیچھے کا ڈیٹا
[
{
"label": "Gitea, small team",
"ram_gb": 1
},
{
"label": "GitLab, memory constrained",
"ram_gb": 8
},
{
"label": "GitLab, single node baseline",
"ram_gb": 16
}
]Gitea کے مطابق چھوٹی teams اور projects کے لیے 2 CPU cores کے ساتھ 1 GB RAM عموماً کافی ہوتی ہے، اور اس کے مطابق Raspberry Pi 3 بھی چھوٹے workloads کے لیے کافی ہے۔ GitLab ایک single-node installation کے لیے 16 GB کو baseline قرار دیتا ہے، اور 8 GB کو اس ماحول کے لیے کم ترین حد بتاتا ہے جسے اس کا اپنا صفحہ memory constrained environment کہتا ہے۔ Forgejo کی installation documentation میں RAM کی کوئی figure نہیں دی گئی۔ یہ Gitea کا fork ہے اور اسی طرح کام کرتا ہے، اس لیے Gitea کی figure آپ کے لیے دستیاب قریب ترین published guide ہے۔
1 GB VPS پر اس کا مطلب یہ ہے کہ bare repositories اور cgit کے لیے کافی گنجائش رہتی ہے، کیونکہ دونوں میں سے کوئی بھی resident service نہیں چلاتا۔ Forgejo یا Gitea start ہو جائیں گے اور SQLite پر ایک چھوٹی team کو service فراہم کریں گے، لیکن آپ documented floor پر کام کر رہے ہیں؛ اس لیے PostgreSQL اور CI (continuous integration) runner کو اسی box سے باہر رکھیں۔ اگر web interface بغیر کسی error کے غائب ہو جائے تو sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' چلائیں اور Out of memory: Killed process 1181 (forgejo) جیسی line تلاش کریں۔ اس کا مطلب ہے کہ kernel کے out of memory killer نے اسے بند کر دیا ہے۔ 1 GB box پر GitLab کا مسئلہ tuning کا نہیں ہے۔ یہ run نہیں ہوگا۔
درجہ 0: SSH کے ذریعے bare repository
Git میں ایسا کوئی network daemon نہیں ہے جسے شروع کرنا ضروری ہو۔ git push، SSH کے ذریعے دور والے سرے پر git-receive-pack کو عام Unix process کے طور پر چلاتا ہے، اس لیے جس account تک آپ key کے ذریعے پہنچ سکتے ہیں وہ پہلے ہی Git remote ہے۔ repositories کے لیے ایک account بنائیں، اور repositories کو اس کی home directory سے باہر رکھیں تاکہ بعد میں شامل کیا جانے والا web view اس home directory تک رسائی کا محتاج نہ ہو۔
sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
--group --disabled-password --home /home/git git
sudo install -d -m 0755 -o git -g git /srv/git
sudo -u git git init --bare /srv/git/project.git--bare ایسی repository بناتا ہے جس میں working copy نہیں ہوتی، اور server پر یہی رکھی جاتی ہے۔ ایسی repository کی checked-out branch پر push کرنا جس میں working copy موجود ہو، default طور پر refusing to update checked out branch: refs/heads/main کے ساتھ مسترد کر دیا جاتا ہے۔ اس درجے پر یہ سب سے عام غلطی ہے۔
اب account کو key دیں اور اسے clone کریں۔
sudo -u git install -d -m 700 /home/git/.ssh
sudo -u git tee -a /home/git/.ssh/authorized_keys <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop
EOF
sudo -u git chmod 600 /home/git/.ssh/authorized_keysgit remote add origin git@vps.example.com:/srv/git/project.git
git push -u origin mainکامیاب first push کا اختتام * [new branch] main -> main پر ہوتا ہے۔ اگر اختتام git@vps.example.com: Permission denied (publickey) پر ہو تو authentication ہوئی ہی نہیں؛ اس لیے server log کو sudo journalctl -u ssh -n 20 کے ساتھ پڑھیں۔ Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys والی سطر کا مطلب ہے کہ ownership یا file mode غلط ہے، کیونکہ sshd ایسی key file مسترد کر دیتا ہے جس کا owner قابلِ اعتماد نہ ہو یا جسے دوسرے users لکھ سکتے ہوں۔
اگر project کا origin پہلے ہی GitHub کی طرف اشارہ کر رہا ہو تو git remote add origin، error: remote origin already exists. پر رک جاتا ہے۔ اس remote پر اس server کو دوسری push URL کے طور پر شامل کرنے سے ایک git push دونوں کو update کر دیتا ہے۔
اب account سے shell access ہٹا دیں۔
command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" gitgit-shell صرف وہ چند commands قبول کرتا ہے جو Git SSH کے ذریعے بھیجتا ہے، اس لیے interactive login اب prompt کے بجائے ایک message پر رک جاتا ہے:
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.یہی مکمل server ہے۔ اس میں database نہیں ہے، اور upgrade کرنے کے لیے کوئی web process بھی نہیں ہے۔ اس کے بدلے آپ forge کی تمام سہولتیں چھوڑ دیتے ہیں: browsing نہیں، issue tracker نہیں، pull requests نہیں، اور فی-user permission بھی نہیں۔ اس file میں موجود ہر key ہر اس repository کو پڑھ اور لکھ سکتی ہے جس کی ملکیت git user کے پاس ہے۔
درجہ 1: cgit آپ کو database کے بغیر web view فراہم کرتا ہے
cgit ایک CGI (common gateway interface) پروگرام ہے جو C میں لکھا گیا ہے۔ web server اسے ہر request پر ایک بار چلاتا ہے، یہ repositories کو براہِ راست disk سے پڑھتا ہے، اور اپنی کوئی state محفوظ نہیں کرتا۔ Ubuntu 24.04 میں یہ universe component کے طور پر شامل ہے۔
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitاسے /etc/cgitrc میں repository directory کی طرف point کریں:
root-title=Git on example.com
css=/cgit.css
logo=/cgit.png
cache-size=1000
cache-root=/var/cache/cgit
snapshots=tar.gz zip
scan-path=/srv/gitscan-path اس directory کو دیکھتا ہے اور اس میں ملنے والی ہر repository کی فہرست بناتا ہے، اس لیے نئی bare repo اضافی configuration کے بغیر ظاہر ہو جاتی ہے۔ cache-size cached pages کی تعداد ہے، اور اس کی قدر zero ہونے پر caching بند رہتی ہے۔ lines شامل کرنے سے پہلے وہ configuration پڑھیں جو آپ کے package نے پہلے ہی /etc/cgitrc میں رکھی ہے، کیونکہ Debian اور Ubuntu package اپنی کچھ defaults فراہم کرتے ہیں۔
ہر entry repository کی description file کی پہلی line دکھاتی ہے، اس لیے نئی bare repo خود کو Unnamed repository; edit this file 'description' to name the repository. کے طور پر دکھاتی ہے۔ ہر repository کے لیے اسے ایک بار درست کریں:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionnginx site file اور اسے check کرنے کا طریقہ
server {
listen 80;
server_name git.example.com;
root /usr/share/cgit;
try_files $uri @cgit;
location @cgit {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi;
fastcgi_param PATH_INFO $uri;
fastcgi_param QUERY_STRING $args;
fastcgi_param HTTP_HOST $server_name;
fastcgi_pass unix:/run/fcgiwrap.socket;
}
}sudo systemctl enable --now fcgiwrap.socket
sudo nginx -t && sudo systemctl reload nginx
systemctl show fcgiwrap.socket -p Listenroot /usr/share/cgit، cgit.css اور cgit.png کو plain files کے طور پر serve کرتا ہے، جبکہ try_files باقی تمام requests کو /usr/lib/cgit/cgit.cgi پر موجود CGI کے حوالے کرتا ہے۔ اگر /var/log/nginx/error.log میں connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) کے ساتھ 502 page دکھائی دے تو اس کا مطلب ہے کہ socket unit چل نہیں رہی یا کسی دوسری path پر listen کر رہی ہے۔ systemctl show line وہ path دکھاتی ہے جسے یہ حقیقت میں استعمال کرتا ہے۔
اس پر انحصار کرنے سے پہلے دو حدود سمجھ لیں۔ cgit read-only ہے اور اس configuration میں login کی سہولت نہیں رکھتا، اس لیے scan-path کے اندر موجود ہر چیز public ہے: private repository کو اس directory سے باہر رکھیں، یا پوری site کے سامنے HTTP basic authentication لگا دیں۔ CGI web server user کے طور پر چلتی ہے، اس لیے اس user کو /srv/git تک پہنچنے اور ہر repository کو پڑھنے کی اجازت درکار ہے۔ جس directory میں یہ داخل نہیں ہو سکتا، وہ error کے بجائے empty index کے طور پر ظاہر ہوتی ہے۔
Tier 2: مسائل اور pull requests کے لیے Forgejo یا Gitea
Forgejo اور Gitea بنیادی طور پر ایک ہی تصور ہیں: ایک Go binary جو users، organisations، issues، pull requests، releases، package registry اور built-in CI system والی web forge فراہم کرتی ہے۔ Binary اور SQLite مل کر مکمل installation بناتے ہیں، اسی لیے یہ ایسے hardware پر بھی چل جاتے ہیں جس پر GitLab انسٹال نہیں ہو سکتا۔ ذیل کی Compose file وہی ہے جو Forgejo کی documentation میں دی گئی ہے، اور اس میں 24 October 2026 کے مطابق درج image tag استعمال کیا گیا ہے۔
networks:
forgejo:
external: false
services:
server:
image: codeberg.org/forgejo/forgejo:17
container_name: forgejo
environment:
- USER_UID=1000
- USER_GID=1000
restart: always
networks:
- forgejo
volumes:
- ./forgejo:/data
- /etc/localtime:/etc/localtime:ro
ports:
- '3000:3000'
- '222:22'یہ 17 tag v17 line کی پیروی کرتا ہے۔ 26 October 2026 کو جاری ہونے والا Forgejo v17.0.1 موجودہ stable release ہے، اور Forgejo v17 کو 28 January 2027 تک support کرتا ہے۔ پرانی v16 line کی support 29 October 2026 کو ختم ہو گئی، اس لیے 16 tag پر موجود installation کو اب upgrade کرنا چاہیے۔ بعد میں ایک major version سے اگلے major version پر جانا manual upgrade ہے، اس لیے موجودہ version سے آغاز کرنا کم خرچ ہے۔
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1curl line کو HTTP status line دکھانی چاہیے۔ پہلے run کی setup مکمل ہونے سے پہلے یہ /install پر redirect بھی ہو سکتی ہے، جو پھر بھی اس بات کی علامت ہے کہ service چل رہی ہے۔ اگر container اس کے بجائے exit ہو جائے تو عام وجہ ownership ہوتی ہے: ./forgejo directory کا مالک USER_UID میں درج UID (user id) ہونا چاہیے، ورنہ process اپنی data directory میں write نہیں کر سکتا۔ VPS پر Docker Compose میں file layout اور volume ownership rule کی مکمل وضاحت موجود ہے۔
Setup page پر دو جوابات اس بات کا فیصلہ کرتے ہیں کہ clone URLs کام کریں گے یا نہیں۔ SSH port، SSH mapping کا host side ہونا چاہیے۔ اوپر والی Compose file میں یہ 222 ہے، کیونکہ یہ host port 222 کو container کے port 22 سے map کرتی ہے۔ خود 222 port کی کوئی لازمی شرط نہیں: کوئی بھی free host port استعمال ہو سکتا ہے، بشرطیکہ mapping اور یہ جواب ایک جیسے ہوں۔ Domain بھی وہ نام ہونا چاہیے جو users واقعی type کریں گے۔ ان میں سے کوئی ایک غلط ہو تو ہر repository page ایسا clone command دے گا جو اسے copy کرنے والے ہر شخص کے لیے ناکام ہو جائے گا۔ بعد میں دونوں app.ini کے [server] section میں SSH_PORT، SSH_DOMAIN اور ROOT_URL کے طور پر موجود ہوں گے۔
Public instance کے لیے web port کو صرف loopback address ('127.0.0.1:3000:3000') پر publish کریں اور TLS (transport layer security) کے لیے اس کے سامنے nginx رکھیں۔ Gitea بھی اپنی documentation میں استعمال ہونے والی docker.gitea.com/gitea image سے اسی طرح install ہوتا ہے، یا ایک single binary کے طور پر ایک systemd unit اور ایک app.ini کے ساتھ چل سکتا ہے۔ اس کا موجودہ stable release v28.4.0 ہے، جو 15 November 2026 کو شائع ہوا۔ September کے آخر میں v28.0.0 کے ساتھ project نے پرانا 1. prefix ختم کر دیا، اس لیے 1.27 کے بعد release 28 ہے، 1.28 نہیں۔
جب تک ممکن ہو SQLite پر قائم رہیں۔ اس سے instance ایک process اور ایک file تک محدود رہتا ہے، اور کسی اضافی service کی نگرانی کے بغیر reboot کے بعد بھی چلتا ہے۔ جب بیک وقت کئی users write کریں تو PostgreSQL کی اضافی لاگت مناسب ہو جاتی ہے، کیونکہ SQLite writes کو serialise کرتا ہے اور طویل CI runs مسلسل write کرتے رہتے ہیں۔ دونوں projects موجودہ instance کو بعد میں PostgreSQL پر منتقل کر سکتے ہیں، اس لیے یہ ایسا فیصلہ نہیں جس میں آپ ہمیشہ کے لیے پھنس جائیں۔
Forgejo یا Gitea: اصل فرق کیا ہے
دونوں کا بنیادی سلسلہ مشترک ہے۔ Gitea نے 2016 میں Gogs سے fork کیا۔ 2022 کے آخر میں Gitea domain اور trademark کا control ایک کمپنی Gitea Ltd کو منتقل ہوا، اور Codeberg کے ساتھ کئی maintainers نے Forgejo شروع کیا۔ Forgejo کو اس کی community Codeberg e.V. کی سرپرستی میں develop کرتی ہے۔ یہ جرمنی میں registered ایک non-profit association ہے جو project کے domains رکھتی ہے، جبکہ governance Forgejo کے اپنے contributors کے پاس رہتی ہے۔ 2024 میں یہ MIT licence سے GPLv3 (GNU general public license version 3) پر منتقل ہوا۔ Gitea بدستور MIT licensed ہے اور اسے commercial backing کے ساتھ develop کیا جاتا ہے۔
روزمرہ استعمال میں دونوں کے feature sets ایک دوسرے سے ملتے جلتے ہیں، لیکن ان کے درمیان منتقلی آسان نہیں۔ January 2025 کا Forgejo v10.0 آخری release تھا جو Gitea database کو براہ راست استعمال کر سکتا تھا، اور وہ بھی صرف Gitea v1.22 یا اس سے پرانے version سے۔ 16 November 2026 تک Gitea v28.4.0 پر ہے، اس لیے موجودہ Gitea instance سے Forgejo پر supported in-place switch ممکن نہیں۔ Data بھرنے سے پہلے ایک کا انتخاب کریں، اور بعد کی کسی بھی منتقلی کو export اور re-import سمجھیں۔
انتخاب کے لیے مختصر اصول یہ ہے۔ اگر governance آپ کے لیے اہم ہے، یا آپ non-profit umbrella کے تحت project چاہتے ہیں، تو Forgejo چلائیں۔ اگر آپ بڑی install base اور commercial support option چاہتے ہیں، تو Gitea چلائیں۔ دونوں open development کے ساتھ maintained ہیں اور باقاعدگی سے releases جاری کرتے ہیں: Forgejo ہر تین ماہ بعد stable release اور ہر سال LTS (long term support) release جاری کرتا ہے۔ 29 October 2026 تک v17.0.1 موجودہ release اور v15.0.11 LTS ہے۔ Forgejo v17 کو 28 January 2027 تک اور v15 کو 15 July 2027 تک support کرتا ہے، جبکہ v16 کی support 29 October 2026 کو ختم ہو گئی۔ اس لیے major version کو pin کرنے سے پہلے اس کے releases page کو check کریں۔ اگر ان اصولوں سے فیصلہ نہ ہو، تو Forgejo اور Gitea کا مکمل موازنہ واضح کرتا ہے کہ ان کے Actions اور package registries میں کیا فرق ہے۔ Data بھرنے کے بعد switching مہنگی ہونے سے پہلے اسی تفصیل پر فیصلہ کر لینا چاہیے۔
Tier 3: GitLab کچھ کرنے سے پہلے اس کی لاگت
GitLab CE مختلف نوعیت کا software ہے۔ ایک instance باہم کام کرنے والی services کا مجموعہ ہوتا ہے: web application کے لیے Puma، background jobs کے لیے Sidekiq، PostgreSQL، Redis، repository access کے لیے Gitaly، اور سامنے nginx۔ Omnibus package ان سب کو ایک ساتھ install کرتا ہے۔ اس سے installation آسان، لیکن کم از کم memory requirement زیادہ ہو جاتی ہے۔
GitLab کے requirements page میں single-node installation کے لیے 16 GB RAM اور 8 vCPU کو baseline کے طور پر درج کیا گیا ہے، جبکہ memory-constrained environment میں 8 GB کو کم ترین حد بتایا گیا ہے۔ اسی page میں swap disable کرنے کی ہدایت بھی دی گئی ہے، کیونکہ load کے دوران swapping instance کی کارکردگی کو شدید متاثر کرتی ہے۔ یہ اعداد و شمار October 2026 تک شائع شدہ ہیں اور گزشتہ برسوں میں بڑھتے رہے ہیں، اس لیے server کی sizing سے پہلے page دوبارہ دیکھیں۔
اس budget کے عوض آپ کو حقیقی سہولتیں ملتی ہیں: container registry، package registry، باریک سطح کی permissions، اور CI جسے بڑے scale پر آزمایا گیا ہے۔ Compliance Center اور project یا group audit trails کے لیے paid GitLab tier درکار ہوتا ہے۔ اگر آپ کی team میں کوئی بھی اس فہرست میں سے ایسی چیز کا نام نہیں بتا سکتا جس کی اسے اس quarter میں ضرورت ہو، تو آپ کسی فائدے کے بغیر بڑا VPS لینے کی قیمت ادا کر رہے ہیں۔
SSH رسائی کا ماڈل: ایک git صارف اور متعدد keys
system OpenSSH کے ساتھ یہاں ہر سطح پر authentication کا طریقہ یکساں ہے۔ ایک Unix account ہے جس کا نام git ہے، اور ہر public key اس account کی ~/.ssh/authorized_keys میں شامل کی جاتی ہے۔ Authentication key کے ذریعے ہوتی ہے۔ Authorisation ان options پر منحصر ہوتی ہے جو آپ اسی line میں key سے پہلے لکھتے ہیں۔
سادہ key line رکھنے والے کو وہ تمام اختیارات دے دیتی ہے جو اس account کے لیے دستیاب ہیں۔ ایسے account کے لیے جو اب بھی /bin/bash کو login shell کے طور پر استعمال کرتا ہے، forced command رسائی کو Git تک محدود کر دیتی ہے:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptoprestrict، جو OpenSSH 7.2 سے دستیاب ہے، ایک ہی لفظ میں port forwarding، agent forwarding، X11 اور PTY (pseudo terminal) allocation بند کر دیتا ہے۔ command= client کی بھیجی ہوئی command کو آپ کی مقرر کردہ command سے بدل دیتا ہے، اور Git پھر بھی کام کرتا ہے کیونکہ SSH server client کی اصل command $SSH_ORIGINAL_COMMAND میں رکھ دیتا ہے۔
forge یہ file آپ کے لیے بناتا ہے، اور tier 0 اور tier 2 کے درمیان اصل فرق یہی ہے۔ جب یہ system OpenSSH server کے پیچھے چل رہے ہوں، جو ان کا default ہے، تو Forgejo اور Gitea authorized_keys کو دوبارہ لکھ کر ہر registered key کے لیے ایک line شامل کرتے ہیں۔ ہر line میں ایک forced command ہوتی ہے جو database id کے ذریعے key کی شناخت کرتی ہے:
command="/usr/local/bin/forgejo --config=/etc/forgejo/app.ini serv key-3",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty,no-user-rc,restrict ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere aliceیہ forced command ہی ایک مشترکہ Unix account کو ہر user کے لیے الگ permission میں تبدیل کرتی ہے: key-3 forge کو بتاتا ہے کہ کون سا user connect ہو رہا ہے، اور کسی بھی object کے منتقل ہونے سے پہلے forge اس user کو repository کے خلاف چیک کرتا ہے۔ forge کے زیر انتظام box پر اس file کو دستی طور پر edit نہ کریں، کیونکہ یہ database سے دوبارہ لکھی جاتی ہے اور آپ کی line ختم ہو جائے گی۔ اگر آپ forge کا built-in SSH server فعال کر دیں، یا OpenSSH کو AuthorizedKeysCommand کے ذریعے forge سے keys حاصل کرنے کو کہیں، تو forge کو اس file کی بالکل ضرورت نہیں رہتی۔ دونوں projects دوسرے طریقے کی صورت میں اس file کی creation بند کرنے کی ہدایت دیتے ہیں۔ Deploy keys بھی اسی mechanism سے آتی ہیں: deploy key ایک عام SSH key ہوتی ہے جو صرف ایک repository کے ساتھ register کی جاتی ہے۔ عموماً یہ read-only ہوتی ہے، اور اس کی جانچ sshd کے بجائے forge میں ہوتی ہے۔
اوپر دی گئی تمام configuration سے زیادہ اہم دو عادتیں ہیں۔ ہر شخص یا ہر machine کے لیے ایک الگ key جاری کریں، shared key کبھی استعمال نہ کریں، کیونکہ shared key revoke کرنے کے لیے اسے سب کے لیے بیک وقت rotate کرنا پڑتا ہے۔ اور کسی شخص کے جانے کے دن ہی اس کی keys ہٹا دیں، کیونکہ اس file میں موجود پرانی key ایک مستقل login ہے جس کی نگرانی کوئی نہیں کر رہا۔ Server پر SSH key کا اچھا انتظام key types اور passphrases کا احاطہ کرتا ہے، اور اس کی تمام ہدایات یہاں بھی جوں کی توں لاگو ہوتی ہیں۔ اگر box نیا ہے تو repositories رکھنے سے پہلے نئے VPS پر پہلے دس منٹ کے اقدامات کرنا درست ہے۔
کیا میں اپنے Git server پر GitHub Actions چلا سکتا ہوں؟
آپ GitHub Actions syntax میں لکھے گئے workflows چلا سکتے ہیں۔ آپ GitHub نہیں چلا سکتے۔ Forgejo Actions، Forgejo v1.21 سے بطور default فعال ہے اور ہر repository میں .forgejo/workflows سے workflow files پڑھتا ہے۔ Gitea Actions بھی اسی طرح کام کرتا ہے اور .gitea/workflows پڑھتا ہے۔ دونوں کے لیے ایک دوسرے پروگرام، یعنی runner، کو انسٹال کرنا اور admin settings سے حاصل کردہ token کے ذریعے اپنی instance کے ساتھ register کرنا ضروری ہے۔ بہت سی published actions میں تبدیلی کے بغیر چل جاتی ہیں۔
دو نتائج کے لیے پہلے سے منصوبہ بنائیں۔ معمول کے container labels کے ساتھ runner ہر job کے لیے ایک container شروع کرتا ہے۔ اس لیے اسے اپنا container engine اور memory budget درکار ہوتا ہے۔ اسی وجہ سے اسے forge کے ساتھ اسی 1 GB server پر نہیں چلانا چاہیے۔ دونوں runners jobs کو براہِ راست host پر بھی چلا سکتے ہیں۔ Forgejo میں اس کے لیے :host پر ختم ہونے والا label استعمال ہوتا ہے۔ اس صورت میں engine کی ضرورت نہیں ہوتی، لیکن job اور اس machine کے درمیان container کی کوئی isolation بھی نہیں رہتی۔ runner workflow file میں دی گئی ہر ہدایت execute کرتا ہے۔ Forgejo کی documentation اسے واضح الفاظ میں بیان کرتی ہے: runner remote code execution انجام دیتا ہے۔ جہاں ممکن ہو اسے اپنی الگ host دیں۔ کم از کم اسے اپنا الگ unprivileged user اور صرف ایک repository تک محدود registration token دیں۔
اگر آپ کی repositories GitHub پر ہی رہیں گی اور آپ صرف computation اپنی زیرِ انتظام hardware پر چاہتے ہیں تو یہ مختلف setup ہے، جس کے steps بھی مختلف ہیں: ایک self-hosted GitHub Actions runner، GitHub repository کے ساتھ attach ہوتا ہے اور اسے ان میں سے کسی چیز کی ضرورت نہیں ہوتی۔ اگر آپ اب بھی یہ جانچ رہے ہیں کہ GitHub چھوڑنے کی کیا لاگت ہے تو GitHub حقیقت میں آپ کو کیا فراہم کرتا ہے، Git hosting کو اس کے گرد موجود network سے الگ کر کے بیان کرتا ہے۔
بیک اپ: repositories صرف آدھی state محفوظ کرتے ہیں
Bare repository ایک directory ہوتی ہے، اس لیے اسے copy کرنے سے اس کے اندر موجود ہر چیز copy ہو جاتی ہے۔ دوسری machine سے mirror clone ایک حقیقی backup ہے، اور یہ موجودہ جگہ پر تازہ ہو جاتا ہے:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updateیہ ہر ref اور ہر object حاصل کرتا ہے۔ یہ server-side hooks یا description file حاصل نہیں کرتا، اس لیے اگر آپ hooks استعمال کرتے ہیں تو directory کی file-level copy بھی محفوظ رکھیں۔
Forge اپنے database میں issues، pull requests، users، keys اور permissions محفوظ رکھتا ہے، اور صرف repositories کی copy بنانے سے یہ سب ضائع ہو جاتا ہے۔ دونوں projects ایک dump command فراہم کرتے ہیں جو database، repositories، configuration اور attachments کو ایک archive میں لکھتی ہے:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipDocker کے تحت یہی command container کے اندر چلتی ہے، اور configuration path image پر منحصر ہوتا ہے، اس لیے command لکھنے سے پہلے اسے دیکھ لیں:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniاسے اس user کے طور پر چلائیں جو data کا مالک ہو، اور archive کو ایسی directory میں لکھیں جس میں وہ user write کر سکتا ہو۔ پھر archive کو server سے باہر copy کریں، کیونکہ جو backup صرف اسی machine پر موجود ہو جس کا backup لیا جا رہا ہے، وہ backup نہیں ہوتا۔ Restore وہ مرحلہ ہے جسے لوگ چھوڑ دیتے ہیں: ابھی ایک dump کو spare box پر unpack کریں، تاکہ outage کے دوران نہیں بلکہ پُرسکون وقت میں طریقہ کار سیکھ سکیں۔
منظرنامے کے مطابق انتخاب
ایک فرد کے پاس laptop اور VPS ہے، اور اسے browsing کی ضرورت نہیں: SSH کے ذریعے bare repositories استعمال کریں۔ کوئی اضافی service نہیں چلتی، اور upgrade کرنے کے لیے کچھ نہیں ہوتا۔
اگر یہی ضروریات ہوں، لیکن آپ browser میں code پڑھنا اور اس کے links شیئر کرنا چاہتے ہوں: cgit شامل کریں۔ اس صورت میں بھی database درکار نہیں، اور کوئی resident process نہیں چلتا۔
ایسی team جو ایک دوسرے کے code کا review کرتی ہو اور issues track کرتی ہو: 2 GB یا اس سے زیادہ RAM پر Forgejo یا Gitea استعمال کریں۔ جب jobs حقیقی workload بن جائیں تو CI runner کو دوسرے box پر منتقل کریں۔
ایسی organisation جسے container registry اور audit trails درکار ہوں، اور جس کے پاس server کے لیے 16 GB RAM موجود ہو: GitLab استعمال کریں۔ اس budget سے کم میں اسے شروع نہ کریں۔
پہلی تین سطحوں کے درمیان اوپر جانا کم خرچ ہے، کیونکہ ان سب میں repositories disk پر عام Git directories ہوتی ہیں۔ سب سے نچلی وہ سطح منتخب کریں جو کام انجام دے۔ اگر آپ یہ طے کر رہے ہیں کہ اسی server پر مزید کس چیز کے لیے جگہ مختص کی جائے، تو self-hosting کے قابل چیزوں کی مختصر فہرست Git server کو RAM کے لیے مقابلہ کرنے والی دیگر services کے ساتھ رکھتی ہے۔
FAQ
کیا 1 GB VPS، Forgejo یا Gitea چلا سکتا ہے؟
جی ہاں، ایک چھوٹی ٹیم کے لیے، SQLite استعمال کرتے ہوئے، بشرطیکہ اس سرور پر کوئی اور بھاری سروس نہ چل رہی ہو۔ Gitea کی دستاویزات کے مطابق چھوٹی ٹیموں اور پروجیکٹس کے لیے عموماً 1 GB RAM اور 2 CPU cores کافی ہوتے ہیں، اور Forgejo، Gitea کا fork ہے جس کے لیے بھی یہی صورتحال ہے۔ اس مشین پر PostgreSQL یا CI runner شامل نہ کریں۔ اگر سروس اپنی log میں کسی error کے بغیر غائب ہو جائے تو sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' چلائیں: killed process کا نام ظاہر کرنے والی سطر کا مطلب ہے کہ kernel کے out of memory killer نے اسے ختم کیا ہے۔ ایسی صورت میں حل tuning flag نہیں بلکہ بڑا plan ہے۔
Forgejo اور Gitea میں کیا فرق ہے؟
ان دونوں کی codebase history مشترک ہے اور زیادہ تر features بھی یکساں ہیں۔ Gitea، 2016 میں Gogs سے fork ہوا، جبکہ Forgejo، 2022 کے آخر میں Gitea سے fork ہوا، جب Gitea trademark کا control ایک کمپنی کو منتقل ہو گیا۔ Forgejo کو اس کی community، Codeberg e.V. کی نگرانی میں تیار کرتی ہے۔ Codeberg e.V. جرمنی میں قائم ایک non-profit ہے، اور Forgejo کو GPLv3 کے تحت release کیا جاتا ہے؛ Gitea بدستور MIT licensed ہے اور اسے commercial backing حاصل ہے۔ عملی فرق migration path کا ہے۔ جنوری 2025 کا Forgejo v10.0 آخری release تھا جو Gitea database کو براہ راست استعمال کر سکتا تھا، اور یہ صرف Gitea v1.22 یا اس سے پرانے version سے ممکن تھا۔ اس لیے موجودہ Gitea instance کو in-place تبدیل کرنے کا کوئی supported طریقہ نہیں ہے۔
کیا میں self-hosted Git server پر GitHub Actions workflows چلا سکتا ہوں؟
Forgejo Actions اور Gitea Actions دونوں GitHub Actions YAML syntax میں لکھے گئے workflows چلاتے ہیں۔ یہ workflows .forgejo/workflows اور .gitea/workflows سے پڑھے جاتے ہیں۔ آپ کو الگ runner program install کرنا ہوگا اور اسے اپنے instance کے ساتھ register کرنا ہوگا۔ شائع شدہ بہت سے actions میں کوئی تبدیلی ضروری نہیں ہوتی۔ runner آپ کی repositories سے arbitrary code چلاتا ہے اور معمول کے container labels کے ساتھ ہر job کے لیے ایک container شروع کرتا ہے۔ اس لیے اسے اپنی الگ host دیں، یا کم از کم اپنا unprivileged user دیں، اور اسے ایسے 1 GB server پر نہ چلائیں جہاں forge پہلے ہی چل رہا ہو۔
میں self-hosted Git server کا backup کیسے بناؤں؟
Bare repositories کے لیے، کسی دوسری machine سے git clone --mirror چلانے پر ہر ref اور object copy ہو جاتا ہے، جبکہ اسی mirror کے اندر git remote update اسے refresh کرتا ہے۔ Forgejo یا Gitea میں repositories state کا صرف ایک حصہ ہوتی ہیں، کیونکہ issues، pull requests، users اور keys database میں محفوظ ہوتے ہیں۔ Built-in dump، sudo -u git forgejo dump -c /etc/forgejo/app.ini استعمال کریں، یا Docker installation میں یہی command container کے اندر چلائیں۔ Archive کو server سے باہر copy کریں، اور اسے ایک spare machine پر ایک بار restore کریں تاکہ یقین ہو جائے کہ طریقہ کار درست ہے۔