Self-hosted Git server: Forgejo, Gitea या cgit चुनें?
अपने VPS के लिए सही self-hosted Git server चुनें। हम RAM के आधार पर bare repos, cgit, Forgejo, Gitea और GitLab की तुलना करते हैं। जानें कि 1 GB RAM में क्या चलेगा।
आपको कौन सा self-hosted Git server चलाना चाहिए
Self-hosted Git server कोई एक उत्पाद नहीं है, और आपके VPS की RAM (random access memory) यह तय करती है कि आप इसका कौन सा संस्करण चला सकते हैं। Git को अपने किसी daemon की आवश्यकता नहीं होती है: एक bare repository और एक SSH (secure shell) account, आपके द्वारा किराए पर लिए जा सकने वाले सबसे छोटे सर्वर पर भी काम करने के लिए पर्याप्त हैं। उस स्तर से ऊपर की हर चीज़ एक web application है जिसे आप उसके साथ चलाना चुनते हैं, और हर अगले स्तर के लिए ऐसी memory की आवश्यकता होती है जो एक छोटे VPS में शायद न हो। यदि आप अभी भी इस बात को लेकर अनिश्चित हैं कि Git कहाँ समाप्त होता है और GitHub कहाँ से शुरू होता है, तो Git, GitHub और आपके अपने Git server में क्या अंतर है किसी भी विकल्प को चुनने से पहले उस अंतर को स्पष्ट करता है।
इसके चार चरण हैं। SSH पर एक bare repository, जिसमें कोई भी ऐसी चीज़ listen नहीं कर रही जो पहले से listen नहीं कर रही थी। cgit, एक तेज़ read-only web view जिसमें कोई database नहीं होता। Forgejo या Gitea, एक पूर्ण forge जिसमें कुछ सौ megabytes में accounts, issues और pull requests की सुविधा होती है। GitLab, जिसके लिए दूसरों की तुलना में कई गुना बड़े सर्वर की आवश्यकता होती है।
अपने काम की आवश्यकता के अनुसार निर्णय लें, और फिर अपने द्वारा लिए गए plan के memory figure की जाँच करें।
प्रत्येक विकल्प को वास्तव में कितनी RAM की आवश्यकता है
इनमें से केवल दो प्रोजेक्ट हार्डवेयर संबंधी आंकड़े प्रकाशित करते हैं। प्रकाशित आंकड़ों को एक न्यूनतम सीमा मानें, न कि कोई वादा। एक बार जब आपका 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 छोटी टीमों और प्रोजेक्ट्स के लिए सामान्यतः 2 CPU cores के साथ 1 GB RAM को पर्याप्त बताता है और छोटे workloads के लिए Raspberry Pi 3 को सक्षम मानता है। GitLab सिंगल नोड इंस्टॉलेशन के लिए 16 GB को आधार मानता है, और जिसे वह स्वयं memory constrained environment कहता है, उसके लिए 8 GB को न्यूनतम स्तर बताता है। Forgejo का इंस्टॉलेशन डॉक्यूमेंटेशन RAM का कोई आंकड़ा नहीं देता है। यह Gitea का ही एक fork है और उसी तरह काम करता है, इसलिए Gitea का आंकड़ा ही आपके पास उपलब्ध सबसे सटीक मार्गदर्शिका है।
1 GB के VPS पर इसका अर्थ यह है कि bare repositories और cgit अतिरिक्त जगह के साथ चल सकते हैं, क्योंकि इनमें से कोई भी resident service के रूप में नहीं चलता है। Forgejo या Gitea शुरू हो जाएंगे और SQLite पर एक छोटी टीम को सेवा दे पाएंगे, लेकिन चूंकि आप डॉक्यूमेंटेड न्यूनतम सीमा पर हैं, इसलिए उस बॉक्स पर PostgreSQL और CI (continuous integration) runner को न चलाएं। यदि वेब इंटरफेस बिना किसी त्रुटि के गायब हो जाता है, तो sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' चलाएं और Out of memory: Killed process 1181 (forgejo) जैसी लाइन खोजें, जिसका अर्थ है कि kernel out of memory killer ने इसे बंद कर दिया है। 1 GB के बॉक्स पर GitLab चलाना ट्यूनिंग की समस्या नहीं है। यह वहां चलेगा ही नहीं।
Tier 0: SSH पर एक bare repository
Git के लिए आपको किसी network daemon को start करने की आवश्यकता नहीं होती। SSH पर git push दूरस्थ छोर पर एक सामान्य Unix process के रूप में git-receive-pack चलाता है, इसलिए जिस भी 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 में working copy होती है, उसकी checked-out branch पर push करना default रूप से refusing to update checked out branch: refs/heads/main के साथ अस्वीकार कर दिया जाता है, और इस tier पर यह सबसे आम गलती है।
अब 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पहला push जो सफल होता है, वह * [new branch] main -> main के साथ समाप्त होता है। जो git@vps.example.com: Permission denied (publickey) के साथ समाप्त होता है, वह कभी authenticate नहीं हुआ था, इसलिए sudo journalctl -u ssh -n 20 के साथ server log पढ़ें। Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys पढ़ने वाली एक line का अर्थ है कि ownership या file mode गलत है, क्योंकि sshd एक ऐसी key file को अस्वीकार कर देता है जिसका owner अविश्वसनीय है या जिसकी permissions अन्य users को उसे लिखने की अनुमति देती हैं।
यदि project का origin पहले से ही GitHub की ओर इशारा कर रहा है, तो git remote add origin error: remote origin already exists. के साथ रुक जाता है, और इस server को उस remote पर दूसरे push URL के रूप में जोड़ने से एक ही git push दोनों को update कर सकता है।
फिर account से shell वापस ले लें।
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, git user के स्वामित्व वाली हर repository को पढ़ और लिख सकती है।
Tier 1: cgit आपको बिना डेटाबेस के वेब व्यू प्रदान करता है
cgit एक C भाषा में लिखा गया CGI (common gateway interface) प्रोग्राम है। वेब सर्वर इसे प्रत्येक अनुरोध पर एक बार चलाता है, यह सीधे डिस्क से रिपॉजिटरी को पढ़ता है, और यह अपनी कोई भी स्थिति (state) स्टोर नहीं करता है। Ubuntu 24.04 इसे universe कंपोनेंट में उपलब्ध कराता है।
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitइसे /etc/cgitrc में रिपॉजिटरी डायरेक्टरी की ओर निर्देशित करें:
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 उस डायरेक्टरी को स्कैन करता है और मिलने वाली प्रत्येक रिपॉजिटरी को सूचीबद्ध करता है, इसलिए एक नई bare repo बिना किसी अतिरिक्त कॉन्फ़िगरेशन के दिखाई देती है। cache-size कैश किए गए पेजों की संख्या है, और जब यह शून्य होता है तो कैशिंग बंद रहती है। लाइनें जोड़ने से पहले यह पढ़ें कि आपके पैकेज ने पहले से ही /etc/cgitrc में क्या रखा है, क्योंकि Debian और Ubuntu पैकेज में कुछ डिफॉल्ट सेटिंग्स पहले से मौजूद होती हैं।
प्रत्येक प्रविष्टि रिपॉजिटरी की description फाइल की पहली लाइन दिखाती है, इसलिए एक नई bare repo खुद को Unnamed repository; edit this file 'description' to name the repository. के रूप में सूचीबद्ध करती है। इसे प्रति रिपॉजिटरी एक बार ठीक करें:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionnginx साइट फाइल, और इसे चेक करने का तरीका
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 को प्लेन फाइलों के रूप में सर्व करता है, और try_files बाकी सब कुछ /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 पेज का मतलब है कि सॉकेट यूनिट चल नहीं रही है या किसी अन्य पाथ पर लिसन कर रही है। systemctl show लाइन उस पाथ को प्रिंट करती है जिसका वह वास्तव में उपयोग करती है।
इस पर निर्माण करने से पहले दो सीमाओं को जानना आवश्यक है। cgit केवल read-only है और इस कॉन्फ़िगरेशन में कोई लॉगिन नहीं है, इसलिए scan-path के अंतर्गत सब कुछ सार्वजनिक है: किसी प्राइवेट रिपॉजिटरी को उस डायरेक्टरी से बाहर रखें, या पूरी साइट के सामने HTTP basic authentication लगाएँ। और CGI वेब सर्वर यूजर के रूप में चलता है, इसलिए उस यूजर को /srv/git को एक्सेस करने और प्रत्येक रिपॉजिटरी को पढ़ने की अनुमति होनी चाहिए। जिस डायरेक्टरी में वह प्रवेश नहीं कर सकता, वह एरर के बजाय एक खाली इंडेक्स के रूप में दिखाई देती है।
Tier 2: issues और 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 में दी गई file है, जिसमें 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 को released Forgejo v17.0.1 वर्तमान stable release है, और Forgejo v17 को 28 January 2027 तक support करता है। पुरानी v16 line का support 29 October 2026 को समाप्त हो गया। इसलिए 16 tag पर चल रहा existing install अब upgrade के लिए लंबित है। बाद में एक major version से अगले major version पर जाना manual upgrade होता है। इसलिए शुरुआत current version से करना कम खर्चीला है।
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1curl line को HTTP status line print करनी चाहिए। First-run setup पूरा करने से पहले यह /install पर redirect भी हो सकती है। इसका अर्थ फिर भी है कि service चालू है। यदि container इसके बजाय exit हो जाए, तो सामान्य कारण ownership होता है: ./forgejo directory का ownership USER_UID में दिए गए UID (user id) के पास होना चाहिए। अन्यथा process अपनी data directory में write नहीं कर पाता। VPS पर Docker Compose में उस file layout और volume ownership rule को पूरी तरह समझाया गया है।
Setup page पर दो answers यह तय करते हैं कि clone URLs काम करेंगे या नहीं। SSH port, SSH mapping का host side होना चाहिए। ऊपर दी गई Compose file में यह 222 है, क्योंकि यह host port 222 को container के port 22 से map करती है। स्वयं 222 का उपयोग आवश्यक नहीं है। कोई भी free host port काम करेगा, बशर्ते mapping और यह answer एक जैसे हों। Domain वही नाम होना चाहिए, जिसे लोग वास्तव में type करेंगे। इनमें से कोई भी गलत होने पर हर repository page ऐसा clone command देगा, जो उसे copy करने वाले सभी users के लिए fail होगा। बाद में दोनों 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 के रूप में चलाया जा सकता है। इसका current stable release v28.4.0 है, जो 15 November 2026 को published हुआ। September के अंत में v28.0.0 के साथ project ने पुराना 1. prefix हटा दिया। इसलिए 1.27 के बाद की release 28 है, 1.28 नहीं।
जब तक संभव हो SQLite पर बने रहें। इससे instance एक process और एक file तक सीमित रहता है, और supervise करने के लिए किसी अतिरिक्त service के बिना reboot के बाद भी चलता रहता है। जब कई users एक साथ write करते हैं, तब PostgreSQL की अतिरिक्त लागत उचित होती है, क्योंकि SQLite writes को serialise करता है और लंबे CI runs लगातार write करते हैं। दोनों projects existing instance को बाद में PostgreSQL पर migrate कर सकते हैं। इसलिए यह ऐसा निर्णय नहीं है, जिसमें आप स्थायी रूप से फंस जाएँ।
Forgejo या Gitea: वास्तव में क्या अलग है
दोनों की lineage साझा है। Gitea ने 2016 में Gogs से fork किया। 2022 के अंत में Gitea domain और trademark का control एक company, Gitea Ltd, को चला गया। इसके बाद कई maintainers ने Codeberg के साथ मिलकर Forgejo शुरू किया। Forgejo को Codeberg e.V. के umbrella के तहत उसकी community develop करती है। यह Germany में 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 काफी समान हैं। इनके बीच migration path समान नहीं है। January 2025 का Forgejo v10.0 अंतिम release था, जो Gitea database को सीधे import कर सकता था। वह भी केवल Gitea v1.22 या उससे पुराने version से। 16 November 2026 तक Gitea v28.4.0 पर है। इसलिए current Gitea instance को Forgejo में बदलने के लिए कोई supported in-place switch उपलब्ध नहीं है। Instance में data भरने से पहले एक चुनें। बाद के किसी भी migration को export और re-import मानकर चलें।
चुनने का संक्षिप्त नियम यह है। यदि governance आपके लिए महत्वपूर्ण है या आप non-profit umbrella के तहत project चाहते हैं, तो Forgejo चलाएँ। यदि आप बड़ा install base और commercial support option चाहते हैं, तो Gitea चलाएँ। दोनों projects open development में maintained हैं और अक्सर release होते हैं। Forgejo हर तीन महीने में stable release और हर वर्ष LTS (long term support) release जारी करता है। 29 October 2026 के अनुसार v17.0.1 current है और v15.0.11 LTS है। Forgejo v17 को 28 January 2027 तक और v15 को 15 July 2027 तक support करता है। v16 का support 29 October 2026 को समाप्त हो गया। इसलिए किसी major version को pin करने से पहले उसकी releases page जाँचें। यदि इनमें से कोई नियम निर्णय तय नहीं करता, तो Forgejo और Gitea की पूरी तुलना बताती है कि इनके Actions और package registries कैसे अलग हैं। आपके data के कारण switching महंगा होने से पहले इसी detail पर निर्णय लें।
Tier 3: GitLab के उपयोग से पहले उसकी लागत
GitLab CE एक अलग श्रेणी का सॉफ्टवेयर है। एक instance कई सहयोगी सेवाओं का समूह है: वेब एप्लिकेशन के लिए Puma, बैकग्राउंड जॉब्स के लिए Sidekiq, PostgreSQL, Redis, रिपॉजिटरी एक्सेस के लिए Gitaly, और सामने की तरफ nginx। Omnibus पैकेज इन्हें एक साथ इंस्टॉल करता है, जिससे इंस्टॉलेशन सरल हो जाता है लेकिन मेमोरी की न्यूनतम आवश्यकता काफी अधिक हो जाती है।
GitLab का requirements पेज सिंगल नोड इंस्टॉलेशन के लिए 16 GB RAM और 8 vCPU को आधार मानता है, जबकि मेमोरी की कमी वाले वातावरण में 8 GB को न्यूनतम बताया गया है। वही पेज आपको swap डिसेबल करने का निर्देश देता है, क्योंकि लोड के दौरान swapिंग instance के प्रदर्शन को बुरी तरह प्रभावित करती है। अक्टूबर 2026 तक के ये प्रकाशित आंकड़े हैं, और वर्षों में इनमें वृद्धि हुई है, इसलिए सर्वर का आकार तय करने से पहले पेज को दोबारा पढ़ें।
इस बजट के बदले आपको वास्तविक सुविधाएं मिलती हैं: एक कंटेनर रजिस्ट्री, एक पैकेज रजिस्ट्री, विस्तृत अनुमतियाँ (permissions) और CI, जिसे बड़े पैमाने पर टेस्ट किया गया है; कंप्लायंस सेंटर और प्रोजेक्ट या ग्रुप ऑडिट ट्रेल्स के लिए भुगतान किए गए GitLab टियर की आवश्यकता होती है। यदि आपकी टीम में कोई भी इस सूची से ऐसी किसी चीज़ का नाम नहीं ले सकता जिसकी उन्हें इस तिमाही में आवश्यकता है, तो आप बिना किसी लाभ के एक बड़े VPS के लिए भुगतान कर रहे हैं।
SSH एक्सेस मॉडल: एक git यूजर और कई कीज़
सिस्टम OpenSSH के साथ, यहाँ हर टियर एक ही तरीके से ऑथेंटिकेट करता है। इसमें git नाम का एक Unix अकाउंट होता है, और हर पब्लिक की उस अकाउंट की ~/.ssh/authorized_keys फाइल में जाती है। ऑथेंटिकेशन की (key) के माध्यम से होता है। ऑथराइजेशन वह है जो आप उसी लाइन पर की (key) के सामने लिखते हैं।
एक साधारण की (key) लाइन धारक को वह सब कुछ करने की अनुमति देती है जो वह अकाउंट कर सकता है। जिस अकाउंट में अभी भी लॉगिन शेल के रूप में /bin/bash का उपयोग होता है, वहां एक forced command उसे Git तक सीमित कर देती है:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptoprestrict, जो OpenSSH 7.2 के बाद से उपलब्ध है, एक ही शब्द में पोर्ट फॉरवर्डिंग, एजेंट फॉरवर्डिंग, X11 और PTY (स्यूडो टर्मिनल) एलोकेशन को बंद कर देता है। command= क्लाइंट द्वारा मांगी गई कमांड को आपके द्वारा दी गई कमांड से बदल देता है, और Git फिर भी काम करता है क्योंकि SSH सर्वर क्लाइंट की मूल कमांड को $SSH_ORIGINAL_COMMAND में डाल देता है।
एक फोर्ज (forge) आपके लिए वह फाइल लिखता है, और टियर 0 और टियर 2 के बीच यही वास्तविक अंतर है। जब वे सिस्टम OpenSSH सर्वर के पीछे होते हैं, जो कि उनका डिफ़ॉल्ट है, तो Forgejo और Gitea authorized_keys को हर रजिस्टर्ड की (key) के लिए एक लाइन के साथ फिर से लिखते हैं, जिसमें से प्रत्येक में एक forced command होती है जो की (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 अकाउंट प्रति-यूजर अनुमति में बदल जाता है: key-3 फोर्ज को बताता है कि कौन सा यूजर कनेक्ट कर रहा है, और किसी भी ऑब्जेक्ट के मूव होने से पहले यह रिपॉजिटरी के खिलाफ उस यूजर की जांच करता है। फोर्ज द्वारा प्रबंधित बॉक्स पर उस फाइल को मैन्युअल रूप से एडिट न करें, क्योंकि इसे डेटाबेस से फिर से लिखा जाता है और आपकी लाइन गायब हो जाएगी। यदि आप फोर्ज के इन-बिल्ट SSH सर्वर को चालू करते हैं, या OpenSSH को AuthorizedKeysCommand के माध्यम से फोर्ज से कीज़ (keys) मांगने के लिए कहते हैं, तो फोर्ज को उस फाइल की बिल्कुल भी आवश्यकता नहीं होती है, और दूसरे मामले में दोनों प्रोजेक्ट्स आपको इसे बनाना बंद करने के लिए कहते हैं। डिप्लॉय कीज़ (deploy keys) उसी तंत्र से आती हैं: एक डिप्लॉय की (deploy key) एक साधारण SSH की (key) होती है जो एक सिंगल रिपॉजिटरी के खिलाफ रजिस्टर्ड होती है, आमतौर पर read-only, जिसमें जांच sshd के बजाय फोर्ज में की जाती है।
ऊपर दिए गए किसी भी कॉन्फ़िगरेशन से अधिक दो आदतें मायने रखती हैं। प्रति व्यक्ति या प्रति मशीन एक की (key) जारी करें, कभी भी साझा की (key) का उपयोग न करें, क्योंकि साझा की (key) को रद्द करने का मतलब है कि सभी के लिए इसे एक साथ बदलना। और जिस दिन कोई व्यक्ति छोड़ दे, उस दिन कीज़ (keys) को हटा दें, क्योंकि उस फाइल में एक पुरानी की (key) एक स्थायी लॉगिन है जिसे कोई नहीं देख रहा है। सर्वर पर SSH की (key) का बेहतर प्रबंधन की (key) के प्रकारों और पासफ़्रेज़ को कवर करता है, और यह सब यहाँ बिना किसी बदलाव के लागू होता है। यदि बॉक्स नया है, तो रिपॉजिटरी डालने से पहले नए VPS पर शुरुआती दस मिनट का पालन करना सही रहता है।
क्या मैं अपने Git सर्वर पर GitHub Actions चला सकता हूँ?
आप GitHub Actions सिंटैक्स में लिखे गए वर्कफ़्लो चला सकते हैं। आप GitHub नहीं चला सकते। Forgejo v1.21 के बाद से Forgejo Actions डिफ़ॉल्ट रूप से सक्षम है और यह प्रत्येक रिपॉजिटरी में .forgejo/workflows से वर्कफ़्लो फ़ाइलों को पढ़ता है। Gitea Actions भी इसी तरह काम करता है और .gitea/workflows को पढ़ता है। दोनों के लिए एक दूसरे प्रोग्राम, रनर (runner), की आवश्यकता होती है, जिसे एडमिन सेटिंग्स से प्राप्त टोकन के साथ आपके इंस्टेंस पर इंस्टॉल और रजिस्टर किया जाना चाहिए। कई प्रकाशित (published) एक्शन्स बिना किसी बदलाव के चलते हैं।
दो परिणामों के लिए योजना बनाएँ। सामान्य कंटेनर लेबल के साथ, रनर प्रत्येक जॉब के लिए एक कंटेनर शुरू करता है, इसलिए इसे एक कंटेनर इंजन और अपने स्वयं के मेमोरी बजट की आवश्यकता होती है। यही कारण है कि इसे फोर्ज (forge) वाले उसी 1 GB बॉक्स पर नहीं रखा जाना चाहिए। दोनों रनर सीधे होस्ट पर भी जॉब चला सकते हैं, इसके लिए Forgejo पर :host में समाप्त होने वाले लेबल का उपयोग किया जाता है, जिसके लिए किसी इंजन की आवश्यकता नहीं होती है, लेकिन यह जॉब और उस मशीन के बीच कोई कंटेनर भी नहीं रखता है। रनर वही निष्पादित (execute) करता है जो वर्कफ़्लो फ़ाइल में लिखा होता है, जिसे Forgejo के दस्तावेज़ स्पष्ट शब्दों में बताते हैं: रनर रिमोट कोड निष्पादन (remote code execution) करता है। जहाँ संभव हो इसे अपना अलग होस्ट दें, या कम से कम इसे एक अनप्रिविलेज्ड (unprivileged) यूजर और एक रिपॉजिटरी तक सीमित रजिस्ट्रेशन टोकन दें।
यदि आपकी रिपॉजिटरी GitHub पर ही रह रही हैं और आप केवल अपने नियंत्रण वाले हार्डवेयर पर कंप्यूटिंग करना चाहते हैं, तो यह एक अलग सेटअप है जिसके चरण भी अलग हैं: a self-hosted GitHub Actions runner एक GitHub रिपॉजिटरी से जुड़ता है और इसके लिए इनमें से किसी की आवश्यकता नहीं होती है। यदि आप अभी भी यह तौल रहे हैं कि GitHub छोड़ने की क्या कीमत है, तो what GitHub actually gives you Git होस्टिंग को उसके आसपास के नेटवर्क से अलग करके समझाता है।
बैकअप: रिपॉजिटरी केवल आधी स्थिति है
एक bare रिपॉजिटरी एक डायरेक्टरी होती है, इसलिए इसे कॉपी करने से इसमें मौजूद सब कुछ कॉपी हो जाता है। किसी अन्य मशीन से mirror clone एक वास्तविक बैकअप है, और यह अपनी जगह पर ही रिफ्रेश हो जाता है:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updateयह हर ref और हर object को पुल करता है। यह server-side hooks या description फाइल को पुल नहीं करता है, इसलिए यदि आप hooks का उपयोग करते हैं तो डायरेक्टरी की फाइल-लेवल कॉपी भी रखें।
एक फोर्ज अपने डेटाबेस में issues, pull requests, users, keys और permissions को रखता है, और केवल रिपॉजिटरी की कॉपी रखने से यह सब छूट जाता है। दोनों प्रोजेक्ट्स एक dump कमांड प्रदान करते हैं जो डेटाबेस, रिपॉजिटरी, कॉन्फ़िगरेशन और अटैचमेंट्स को एक आर्काइव में लिखता है:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipDocker के अंतर्गत वही कमांड कंटेनर के अंदर चलती है, और कॉन्फ़िगरेशन पाथ इमेज पर निर्भर करता है, इसलिए टाइप करने से पहले देख लें:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniइसे उस यूजर के रूप में चलाएं जो डेटा का मालिक है, और आर्काइव को ऐसी डायरेक्टरी में लिखें जिसमें वह यूजर लिख सके। फिर आर्काइव को सर्वर से बाहर कॉपी करें, क्योंकि जो बैकअप केवल उसी मशीन पर मौजूद है जिसका बैकअप लिया जा रहा है, वह बैकअप नहीं है। रिस्टोर करना वह चरण है जिसे लोग छोड़ देते हैं: अभी एक अतिरिक्त मशीन पर एक डंप को अनपैक करें, ताकि आप शांत समय में प्रक्रिया सीख सकें, न कि आउटेज के दौरान।
परिदृश्य के अनुसार चयन
एक व्यक्ति जिसके पास लैपटॉप और एक VPS है, और जिसे ब्राउज़िंग की आवश्यकता नहीं है: SSH पर bare repositories का उपयोग करें। इसमें कोई अतिरिक्त service नहीं चलती है और न ही किसी चीज़ को अपग्रेड करने की आवश्यकता होती है।
वही स्थिति, लेकिन आप ब्राउज़र में कोड पढ़ना चाहते हैं और लिंक भेजना चाहते हैं: cgit जोड़ें। इसमें अभी भी किसी database की आवश्यकता नहीं है और न ही कोई resident service चलती है।
एक टीम जो एक-दूसरे के कोड की समीक्षा करती है और issues को ट्रैक करती है: 2 GB RAM या उससे अधिक पर Forgejo या Gitea का उपयोग करें। जब jobs का लोड बढ़ जाए, तो CI runner को दूसरे box पर स्थानांतरित कर दें।
एक संगठन जिसे container registry और audit trails की आवश्यकता है, और सर्वर पर 16 GB RAM उपलब्ध है: GitLab का उपयोग करें। यदि बजट इससे कम है, तो इसे शुरू न करें।
पहले तीन स्तरों पर आगे बढ़ना सस्ता है, क्योंकि उन सभी में repositories डिस्क पर सामान्य Git directories होती हैं। उस सबसे निचले स्तर से शुरुआत करें जो आपका काम पूरा कर दे। यदि आप यह तय कर रहे हैं कि उसी सर्वर पर और क्या जगह पाने का हकदार है, तो self-hosting के लायक सेवाओं की संक्षिप्त सूची में Git सर्वर को उन अन्य सेवाओं के साथ रखा गया है जो उस RAM के लिए प्रतिस्पर्धा कर रही हैं।
FAQ
क्या 1 GB RAM वाले VPS पर Forgejo या Gitea चल सकता है?
हाँ, एक छोटी टीम के लिए, SQLite का उपयोग करके, यदि सर्वर पर कोई अन्य भारी सेवा न चल रही हो। Gitea का दस्तावेज़ीकरण बताता है कि 1 GB RAM और 2 CPU कोर छोटी टीमों और प्रोजेक्ट्स के लिए पर्याप्त हैं, और Forgejo, Gitea का ही एक fork है जिसकी कार्यक्षमता समान है। उस मशीन पर PostgreSQL या CI runner न जोड़ें। यदि सेवा बिना किसी त्रुटि के अपने लॉग से गायब हो जाती है, तो sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' चलाएँ: यदि आउटपुट में किसी प्रक्रिया का नाम आता है, तो इसका मतलब है कि kernel के out of memory killer ने उसे बंद कर दिया है। ऐसी स्थिति में, ट्यूनिंग फ्लैग के बजाय एक बड़े प्लान (अधिक RAM) की आवश्यकता होती है।
Forgejo और Gitea में क्या अंतर है?
दोनों का कोडबेस इतिहास और अधिकांश फीचर्स समान हैं। Gitea को 2016 में Gogs से अलग (fork) किया गया था, और Forgejo को 2022 के अंत में Gitea से अलग किया गया, जब Gitea ट्रेडमार्क का नियंत्रण एक कंपनी के पास चला गया। Forgejo का विकास जर्मनी की एक गैर-लाभकारी संस्था Codeberg e.V. के अंतर्गत समुदाय द्वारा किया जाता है और इसे GPLv3 लाइसेंस के तहत जारी किया गया है; Gitea MIT लाइसेंस के तहत है और इसे व्यावसायिक समर्थन प्राप्त है। व्यावहारिक अंतर माइग्रेशन के रास्ते में है। जनवरी 2025 का Forgejo v10.0, Gitea डेटाबेस को सीधे स्वीकार करने वाला अंतिम रिलीज़ था, और वह भी केवल Gitea v1.22 या उससे पुराने संस्करणों से। इसलिए, वर्तमान Gitea इंस्टेंस के लिए कोई समर्थित इन-प्लेस स्विच उपलब्ध नहीं है।
क्या मैं self-hosted Git सर्वर पर GitHub Actions वर्कफ़्लो चला सकता हूँ?
Forgejo Actions और Gitea Actions दोनों ही GitHub Actions YAML सिंटैक्स में लिखे गए वर्कफ़्लो को चलाते हैं, जिन्हें .forgejo/workflows और .gitea/workflows से पढ़ा जाता है। आपको एक अलग runner प्रोग्राम इंस्टॉल करना होगा और उसे अपने इंस्टेंस के साथ रजिस्टर करना होगा। कई प्रकाशित actions बिना किसी बदलाव के काम करते हैं। runner आपके रिपॉजिटरी से मनमाना कोड निष्पादित करता है और, सामान्य कंटेनर लेबल के साथ, प्रत्येक जॉब के लिए एक कंटेनर शुरू करता है। इसलिए, इसे एक अलग होस्ट दें, या कम से कम एक अलग unprivileged user दें, और इसे 1 GB वाले उस सर्वर से दूर रखें जहाँ पहले से ही forge चल रहा है।
मैं self-hosted Git सर्वर का बैकअप कैसे लूँ?
bare रिपॉजिटरी के लिए, किसी अन्य मशीन से git clone --mirror का उपयोग करके हर ref और object को कॉपी किया जा सकता है, और उस मिरर के अंदर git remote update उसे रिफ्रेश करता है। Forgejo या Gitea के लिए, रिपॉजिटरी केवल स्थिति का एक हिस्सा हैं, क्योंकि issues, pull requests, users और keys डेटाबेस में रहते हैं। इन-बिल्ट डंप टूल, sudo -u git forgejo dump -c /etc/forgejo/app.ini का उपयोग करें, या Docker इंस्टॉलेशन के लिए कंटेनर के अंदर यही कमांड चलाएँ। आर्काइव को सर्वर से बाहर कॉपी करें, और एक बार किसी अतिरिक्त मशीन पर रिस्टोर करके देखें ताकि आप सुनिश्चित हो सकें कि प्रक्रिया सही ढंग से काम करती है।