Self-hosted Git server: Forgejo, Gitea की cgit?
तुमच्या VPS च्या RAM नुसार Git server निवडा: SSH bare repository, 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 मिळून तुम्ही भाड्याने घेऊ शकता अशा सर्वात लहान box वरही कार्यरत server तयार होतो. त्यापुढील प्रत्येक पर्याय हा त्याच्या शेजारी चालवायचा web application असतो. प्रत्येक पुढच्या स्तराला अधिक memory लागते आणि ती लहान VPS मध्ये उपलब्ध असेलच असे नाही. Git कुठे संपते आणि GitHub कुठे सुरू होते याबाबत अजूनही खात्री नसल्यास, स्तर निवडण्यापूर्वी Git, GitHub आणि तुमच्या स्वतःच्या Git server मधील फरक हे विभाजन स्पष्ट करते.
याचे चार स्तर आहेत. SSH द्वारे bare repository, ज्यासाठी आधीपासून ऐकू येत असलेल्या व्यतिरिक्त कोणताही नवीन listener आवश्यक नसतो. cgit हे database शिवायचे, जलद read-only web view आहे. Forgejo किंवा Gitea हे accounts, issues आणि pull requests असलेले पूर्ण forge आहेत आणि त्यांना काही hundred megabytes memory लागते. GitLab ला इतर पर्यायांपेक्षा अनेक पटींनी मोठा server अपेक्षित असतो.
तुम्हाला करायच्या कामानुसार निर्णय घ्या. त्यानंतर memory figure तुम्ही पैसे देत असलेल्या plan शी जुळते का ते तपासा.
प्रत्येक पर्यायाला प्रत्यक्षात किती RAM आवश्यक आहे
यापैकी केवळ दोन प्रकल्प 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 सामान्यतः पुरेशी असते. लहान workloads साठी Raspberry Pi 3 पुरेसा असल्याचेही ते नमूद करते. GitLab नुसार, single node installation साठी 16 GB ही baseline आहे. तसेच, त्याच्या स्वतःच्या पृष्ठावरील शब्दांत, memory constrained environment साठी 8 GB ही किमान पातळी आहे. Forgejo च्या installation documentation मध्ये RAM चे कोणतेही figure दिलेले नाही. ते Gitea चे fork आहे आणि त्याचप्रमाणे कार्य करते. त्यामुळे तुमच्याकडे उपलब्ध असलेला सर्वात जवळचा प्रकाशित मार्गदर्शक म्हणजे Gitea चे figure.
1 GB VPS वर याचा अर्थ असा होतो: bare repositories आणि cgit पुरेशी मोकळीक ठेवून चालतात, कारण त्यापैकी कोणतीही resident service चालवत नाही. Forgejo किंवा Gitea सुरू होतील आणि SQLite वर small team साठी सेवा देतील. मात्र तुम्ही 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 ने ती process बंद केली आहे. 1 GB box वरील GitLab ही tuning ची समस्या नाही. ते चालणार नाही.
Tier 0: SSH वरील bare repository
Git मध्ये सुरू करावी लागणारी कोणतीही network daemon सेवा नाही. git push SSH द्वारे दूरच्या बाजूला सामान्य Unix process म्हणून git-receive-pack चालवते. त्यामुळे key द्वारे ज्या account पर्यंत पोहोचता येते, तो account आधीपासूनच Git remote असतो. Repositories साठी एक account तयार करा. भविष्यात web view जोडल्यास त्या account च्या home directory ला access देण्याची गरज पडू नये म्हणून repositories त्याच्या 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 working copy शिवाय repository तयार करते. सर्व्हरवर ठेवण्यासाठी हेच योग्य असते. working copy असलेल्या repository च्या checked-out branch वर push करणे refusing to update checked out branch: refs/heads/main मुळे default ने नाकारले जाते. या 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) ने समाप्त होणारा push authenticate झालेलाच नसतो. त्यामुळे sudo journalctl -u ssh -n 20 वापरून server log वाचा. Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys अशी ओळ दिसल्यास ownership किंवा file mode चुकीचा आहे. अविश्वसनीय मालक असलेली किंवा इतर users ना लिहिण्याची परवानगी देणारी key file sshd नाकारते.
प्रकल्पाचा origin आधीच GitHub कडे निर्देश करत असल्यास, git remote add origin error: remote origin already exists. वर थांबते. या server ला त्या remote वर दुसरा 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 Git SSH द्वारे पाठवणाऱ्या मोजक्या commands स्वीकारते. त्यामुळे interactive login आता prompt ऐवजी संदेश दाखवून थांबतो:
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 चे read आणि write access मिळते.
टियर 1: cgit मुळे database शिवाय web view उपलब्ध होते
cgit हा C मध्ये लिहिलेला CGI (common gateway interface) प्रोग्राम आहे. प्रत्येक request साठी web server तो एकदा चालवतो. तो 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 कडे त्याचे निर्देश करा:
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 बंद राहते. ओळी जोडण्यापूर्वी package ने /etc/cgitrc मध्ये आधीच काय लिहिले आहे ते वाचा, कारण Debian आणि Ubuntu package स्वतःची काही defaults देतात.
प्रत्येक entry मध्ये repository च्या description file मधील पहिली ओळ दाखवली जाते. त्यामुळे नवीन 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 आणि ते कसे तपासायचे
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 दाखवते.
यावर आधारित configuration करण्यापूर्वी दोन मर्यादा लक्षात ठेवा. या configuration मध्ये cgit read-only आहे आणि त्यामध्ये login नाही. त्यामुळे scan-path अंतर्गत असलेली प्रत्येक गोष्ट public आहे. Private repository त्या directory च्या बाहेर ठेवा किंवा संपूर्ण site समोर HTTP basic authentication लावा. CGI web server user म्हणून चालतो. त्यामुळे त्या user ला /srv/git मधून पुढे जाण्याची आणि प्रत्येक repository वाचण्याची परवानगी आवश्यक आहे. ज्या directory मध्ये तो प्रवेश करू शकत नाही ती error ऐवजी रिकाम्या index म्हणून दिसते.
Tier 2: issues आणि pull requests साठी Forgejo किंवा Gitea
Forgejo आणि Gitea ही एकाच संकल्पनेची अंमलबजावणी आहेत: users, organisations, issues, pull requests, releases, package registry आणि built-in CI system देणारी एक Go binary. Binary आणि SQLite एवढेच संपूर्ण installation असल्यामुळे GitLab ज्या hardware वर चालणार नाही, त्यावरही हे चालतात. खालील 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 रोजी release झालेला 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 दाखवली पाहिजे. First-run setup पूर्ण करण्यापूर्वी ती /install कडे redirect असू शकते. तरीही याचा अर्थ service सुरू आहे. त्याऐवजी container बंद होत असेल, तर नेहमीचे कारण ownership असते: ./forgejo directory ही USER_UID मधील UID (user id) च्या मालकीची असली पाहिजे. अन्यथा process स्वतःच्या data directory मध्ये लिहू शकत नाही. VPS वर Docker Compose मध्ये file layout आणि volume ownership rule यांचे सविस्तर वर्णन आहे.
Setup page वरील दोन answers मुळे clone URLs कार्य करतील की नाही हे ठरते. SSH port हा SSH mapping च्या host side वरील port असला पाहिजे. वरील Compose file मध्ये तो 222 आहे, कारण तो host port 222 ला container च्या port 22 शी map करतो. स्वतः 222 port वापरणे आवश्यक नाही. Mapping आणि हा answer परस्परांशी जुळत असतील, तर कोणताही मोकळा host port वापरता येतो. Domain हे लोक प्रत्यक्षात type करणार असलेले name असले पाहिजे. यापैकी एकही चुकीचे असल्यास, प्रत्येक repository page वर अशी clone command दिसेल जी ती copy करणाऱ्या प्रत्येकासाठी fail होईल. नंतर ही दोन्ही माहिती app.ini मधील [server] section मध्ये, SSH_PORT, SSH_DOMAIN आणि ROOT_URL म्हणून असते.
Public instance साठी web port फक्त loopback address वर publish करा ('127.0.0.1:3000:3000') आणि TLS (transport layer security) साठी त्याच्या समोर nginx ठेवा. Gitea चे installation documentation मध्ये वापरलेल्या docker.gitea.com/gitea image मधून याच पद्धतीने करता येते. किंवा one systemd unit आणि one app.ini सह single binary म्हणूनही ते चालवता येते. त्याचा सध्याचा 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 एवढ्यावर राहते. तसेच supervise करण्यासाठी अतिरिक्त service नसल्यामुळे reboot नंतरही ते सहज सुरू होते. एकाच वेळी अनेक लोक लिहित असतील, तर PostgreSQL चा अतिरिक्त खर्च योग्य ठरतो. SQLite writes क्रमाने करते, तर मोठे CI runs सतत writes करतात. दोन्ही projects existing instance नंतर PostgreSQL वर हलवू शकतात. त्यामुळे हा कायमचा निर्णय नाही.
Forgejo किंवा Gitea: प्रत्यक्षात काय वेगळे आहे
दोन्हींची lineage समान आहे. Gitea हे 2016 मध्ये Gogs मधून fork झाले. 2022 च्या उत्तरार्धात Gitea domain आणि trademark वरील नियंत्रण Gitea Ltd नावाच्या company कडे गेले. त्यानंतर Codeberg सोबत अनेक maintainers नी Forgejo सुरू केले. Forgejo हे Codeberg e.V. च्या umbrella अंतर्गत त्याच्या community कडून विकसित केले जाते. Codeberg e.V. ही Germany मध्ये registered non-profit association आहे आणि project चे domains तिच्या मालकीचे आहेत. मात्र governance Forgejo च्या स्वतःच्या contributors कडेच राहते. 2024 मध्ये ते MIT licence वरून GPLv3 (GNU general public license version 3) वर गेले. Gitea अजूनही MIT licensed आहे आणि त्याचा development commercial backing सह केला जातो.
दैनंदिन वापरात feature sets जवळपास समान आहेत. मात्र एका project मधून दुसऱ्याकडे जाण्याचा मार्ग सोपा नाही. January 2025 मधील Forgejo v10.0 हा Gitea database थेट स्वीकारू शकणारा शेवटचा release होता. त्यासाठीही Gitea v1.22 किंवा त्यापेक्षा जुनी version आवश्यक होती. 16 November 2026 रोजी Gitea v28.4.0 वर आहे. त्यामुळे current Gitea instance मधून Forgejo कडे supported in-place switch उपलब्ध नाही. Data भरायच्या आधी एक project निवडा. नंतरचे migration export आणि re-import म्हणून करा.
निवडीसाठी एक संक्षिप्त नियम आहे. Governance तुमच्यासाठी महत्त्वाचे असेल किंवा non-profit umbrella अंतर्गत असलेला project हवा असेल, तर Forgejo चालवा. मोठा install base आणि commercial support option हवा असेल, तर Gitea चालवा. दोन्ही projects open development पद्धतीने maintained आहेत आणि वारंवार releases देतात. Forgejo दर तीन महिन्यांनी stable release आणि दरवर्षी LTS (long term support) release देते. 29 October 2026 रोजी v17.0.1 current release आणि v15.0.11 LTS release होते. 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 migration बदलणे महागडे करण्यापूर्वी हाच तपशील निश्चित करा.
Tier 3: GitLab काहीही करण्यापूर्वी लागणारा खर्च
GitLab CE हे वेगळ्या श्रेणीतील सॉफ्टवेअर आहे. एका instance मध्ये परस्पर सहकार्य करणाऱ्या सेवांचा संच असतो: web application साठी Puma, background jobs साठी Sidekiq, PostgreSQL, Redis, repository access साठी Gitaly आणि समोर nginx. Omnibus package या सर्व सेवा एकत्र install करते. त्यामुळे installation सोपे होते, पण किमान memory आवश्यकता जास्त असते.
GitLab च्या requirements page वर single-node installation साठी baseline म्हणून 16 GB RAM आणि 8 vCPU नमूद आहेत. Memory-constrained environment मध्ये 8 GB ही किमान मर्यादा असल्याचेही त्याच पृष्ठावर सांगितले आहे. Load असताना swapping मुळे instance ची कार्यक्षमता मोठ्या प्रमाणात खालावते, म्हणून swap disable करण्यास सांगितले आहे. October 2026 पर्यंत प्रकाशित केलेले हे आकडे आहेत. गेल्या काही वर्षांत या आवश्यकता वाढल्या आहेत. त्यामुळे server चे sizing करण्यापूर्वी ते पृष्ठ पुन्हा वाचा.
या budget मध्ये तुम्हाला उपयुक्त सुविधा मिळतात: container registry, package registry, सूक्ष्म स्तरावरील permissions आणि मोठ्या प्रमाणावर वापरून तपासलेले CI. Compliance center तसेच project किंवा group audit trails साठी paid GitLab tier आवश्यक आहे. तुमच्या team मधील कोणीही या यादीतील या quarter मध्ये आवश्यक असलेली एखादी सुविधा सांगू शकत नसेल, तर तुम्ही कोणताही प्रत्यक्ष लाभ न मिळवता मोठ्या VPS साठी पैसे देत आहात.
SSH प्रवेशाचे मॉडेल: एक git वापरकर्ता आणि अनेक keys
system OpenSSH वापरताना या सर्व स्तरांवर authentication ची पद्धत समान असते. git नावाचे एक Unix account असते आणि प्रत्येक public key त्या account च्या ~/.ssh/authorized_keys मध्ये ठेवली जाते. Authentication साठी key वापरली जाते. Authorisation साठी त्याच ओळीवर key च्या आधी लिहिलेले options लागू होतात.
साध्या key line मुळे त्या account ला करता येणारी सर्व कामे key धारकाला करता येतात. अजूनही /bin/bash हा login shell वापरणाऱ्या account साठी forced command वापरल्यास त्याचा वापर Git पुरता मर्यादित करता येतो:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptopOpenSSH 7.2 पासून उपलब्ध असलेले restrict port forwarding, agent forwarding, X11 आणि PTY (pseudo terminal) allocation एका शब्दात बंद करते. command= client ने मागितलेल्या command ऐवजी तुम्ही निर्दिष्ट केलेली command चालवते. SSH server client ची मूळ command $SSH_ORIGINAL_COMMAND मध्ये ठेवत असल्यामुळे Git तरीही कार्यरत राहते.
Forge तुमच्यासाठी ही file तयार करते. हाच tier 0 आणि tier 2 मधील वास्तविक फरक आहे. त्यांच्या default प्रमाणे ते system OpenSSH server मागे चालत असताना, Forgejo आणि Gitea authorized_keys मध्ये नोंदणीकृत प्रत्येक key साठी एक line लिहितात. प्रत्येक line मध्ये database id द्वारे त्या key ची ओळख सांगणारी forced command असते:
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एकाच Unix account चे प्रत्येक वापरकर्त्यासाठी स्वतंत्र permissions मध्ये रूपांतर forced command मुळे होते: key-3 कोणता वापरकर्ता connect होत आहे हे forge ला सांगते आणि कोणतेही objects transfer होण्यापूर्वी forge त्या वापरकर्त्याची repository विरुद्ध पडताळणी करते. Forge-managed box वर ती file स्वतःहून edit करू नका. ती database मधून पुन्हा लिहिली जाते आणि तुमची line नाहीशी होते. तुम्ही forge चा built-in SSH server सुरू केल्यास किंवा OpenSSH ला AuthorizedKeysCommand द्वारे forge कडून keys मागण्यास सांगितल्यास forge ला ही file अजिबात आवश्यक नसते. दुसऱ्या पद्धतीत ही file तयार करणे बंद करण्यास दोन्ही projects सांगतात. Deploy keys याच mechanism मधून येतात. Deploy key ही एका repository विरुद्ध नोंदणीकृत केलेली सामान्य SSH key असते. ती सहसा read-only असते. तिची पडताळणी sshd ऐवजी forge मध्ये केली जाते.
वरील configuration पेक्षा दोन सवयी अधिक महत्त्वाच्या आहेत. प्रत्येक व्यक्तीसाठी किंवा प्रत्येक machine साठी एक स्वतंत्र key तयार करा; shared key कधीही वापरू नका. Shared key revoke केल्यास ती सर्वांसाठी एकाच वेळी rotate करावी लागते. तसेच एखादी व्यक्ती संस्थेतून बाहेर पडते त्या दिवशी तिच्या keys काढून टाका. त्या file मधील जुनी key म्हणजे कोणीही monitor करत नसलेला कायमस्वरूपी login असतो. Server वरील चांगले SSH key management मध्ये key types आणि passphrases समाविष्ट आहेत. त्यातील सर्व नियम येथेही बदल न करता लागू होतात. Box नवीन असल्यास repositories ठेवण्यापूर्वी नवीन VPS वरील पहिली दहा मिनिटे हा योग्य पुढचा टप्पा आहे.
मी माझ्या स्वतःच्या Git सर्व्हरवर GitHub Actions चालवू शकतो का?
तुम्ही GitHub Actions syntax मध्ये लिहिलेले workflows चालवू शकता. मात्र तुम्ही GitHub चालवू शकत नाही. Forgejo Actions हे Forgejo v1.21 पासून default ने सक्षम आहे आणि प्रत्येक repository मधील .forgejo/workflows येथून workflow files वाचते. Gitea Actions त्याच पद्धतीने कार्य करते आणि .gitea/workflows येथून files वाचते. दोन्हींसाठी runner नावाचा दुसरा program आवश्यक असतो. तो install करून admin settings मधून मिळालेल्या token ने तुमच्या instance विरुद्ध register करावा लागतो. अनेक published actions मध्ये कोणताही बदल न करता चालतात.
दोन परिणामांसाठी आधीच तयारी ठेवा. नेहमीच्या container labels वापरल्यास runner प्रत्येक job साठी एक container सुरू करतो. त्यामुळे त्याला स्वतःचा container engine आणि memory budget आवश्यक असतो. म्हणून forge प्रमाणेच 1 GB box वर तो ठेवू नका. दोन्ही runners jobs थेट host वरही चालवू शकतात. Forgejo मध्ये हे :host ने समाप्त होणाऱ्या label द्वारे करता येते. यासाठी engine आवश्यक नसते; मात्र job आणि त्या machine दरम्यान container isolation देखील राहत नाही. Workflow file मध्ये दिलेले कोणतेही काम runner execute करतो. Forgejo च्या documentation मध्ये हे स्पष्टपणे नमूद केले आहे: runner remote code execution करतो. शक्य असल्यास त्याला स्वतंत्र host द्या. किमान स्वतंत्र unprivileged user आणि एका repository पुरता मर्यादित registration token तरी वापरा.
तुमची repositories GitHub वरच ठेवायची असतील आणि compute फक्त तुमच्या नियंत्रणातील hardware वर चालवायचा असेल, तर ती वेगळी setup आहे आणि तिच्या पायऱ्याही वेगळ्या आहेत: self-hosted GitHub Actions runner हा GitHub repository शी जोडला जातो आणि यापैकी कशाचीही आवश्यकता नसते. GitHub सोडल्यास काय गमवाल याचा तुम्ही अजून विचार करत असाल, तर GitHub तुम्हाला प्रत्यक्षात काय देते हे Git hosting आणि त्याभोवतालच्या network infrastructure मधील फरक स्पष्ट करते.
बॅकअप: repositories हे state चा केवळ एक भाग आहेत
Bare repository ही एक directory असते, त्यामुळे ती copy केल्यावर तिच्यातील सर्व सामग्री copy होते. दुसऱ्या मशीनवरून केलेला mirror clone हा वास्तविक backup असतो आणि तो त्याच ठिकाणी refresh करता येतो:
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 issues, pull requests, users, keys आणि permissions हे database मध्ये ठेवते. त्यामुळे repositories चीच copy घेतल्यास ही सर्व माहिती नष्ट होते. दोन्ही projects database, repositories, configuration आणि attachments एकाच archive मध्ये लिहिणारी dump command देतात:
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.iniData चा मालक असलेल्या user म्हणून ही command चालवा आणि त्या user ला write करता येईल अशा directory मध्ये archive लिहा. त्यानंतर archive serverच्या बाहेर copy करा. कारण backup घेत असलेल्या मशीनवरच अस्तित्वात असलेली copy ही backup नसते. Restore ही लोक बहुतेक वेळा टाळतात. आत्ताच एखादा dump spare box वर unpack करून पाहा. त्यामुळे outage दरम्यान नव्हे, तर निवांत वेळी procedure समजून घेता येईल.
परिस्थितीनुसार निवड
लॅपटॉप आणि VPS असलेली, ब्राउझिंगची गरज नसलेली एक व्यक्ती: SSH द्वारे bare repositories. कोणतीही अतिरिक्त सेवा चालू नसते आणि upgrade करण्यासाठी काहीही नसते.
यासोबतच ब्राउझरमध्ये code वाचायचा आणि त्याच्या links पाठवायच्या असतील, तर cgit जोडा. तरीही database लागत नाही आणि resident process चालू ठेवावा लागत नाही.
एकमेकांच्या code चे reviews घेणाऱ्या आणि issues track करणाऱ्या टीमसाठी, 2 GB किंवा त्याहून अधिक RAM असलेला Forgejo किंवा Gitea वापरा. Jobs प्रत्यक्ष वापरात आल्यावर CI runner दुसऱ्या box वर हलवा.
Container registry आणि audit trails आवश्यक असलेल्या संस्थेसाठी, server वर 16 GB RAM उपलब्ध असल्यास GitLab वापरा. त्यापेक्षा कमी budget असल्यास ते सुरू करू नका.
पहिल्या तीन tiers मध्ये वरच्या tier कडे जाणे स्वस्त आहे, कारण त्या सर्व ठिकाणी repositories disk वरील सामान्य Git directories असतात. काम पूर्ण करणाऱ्या सर्वात कमी tier पासून सुरुवात करा. त्याच server वर आणखी कोणत्या सेवांना जागा द्यायची हे ठरवत असल्यास, self-hosting साठी उपयुक्त पर्यायांची shortlist त्या RAM साठी स्पर्धा करणाऱ्या इतर सेवांच्या शेजारी Git server ठेवते.
FAQ
1 GB VPS वर Forgejo किंवा Gitea चालवता येईल का?
होय. लहान टीमसाठी, SQLite वापरून आणि सर्व्हरवर इतर कोणतेही जड workload नसल्यास ते चालवता येईल. Gitea च्या दस्तऐवजानुसार लहान टीम आणि प्रकल्पांसाठी 1 GB RAM आणि 2 CPU cores सामान्यतः पुरेसे असतात. Forgejo हा Gitea चा fork असल्याने त्याची गरजही साधारण समान आहे. त्या मशीनवर PostgreSQL किंवा CI runner जोडू नका. सेवेच्या स्वतःच्या log मध्ये कोणतीही त्रुटी नसताना ती अचानक बंद होत असेल, तर sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' चालवा. मारल्या गेलेल्या process चे नाव असलेली ओळ दिसल्यास kernel out of memory killer ने तो process बंद केला आहे. अशा वेळी tuning flag वापरण्याऐवजी मोठा plan घ्या.
Forgejo आणि Gitea मध्ये काय फरक आहे?
दोन्हींचा codebase इतिहास आणि बहुतेक features समान आहेत. Gitea हा 2016 मध्ये Gogs पासून fork झाला. Gitea च्या trademark वरील नियंत्रण एका कंपनीकडे गेल्यानंतर, 2022 च्या उत्तरार्धात Forgejo हा Gitea पासून fork झाला. Forgejo चा विकास Codeberg e.V. या जर्मनीतील non-profit संस्थेच्या अधिपत्याखाली community करते आणि तो GPLv3 अंतर्गत release केला जातो. Gitea MIT license अंतर्गतच राहतो आणि त्याला commercial backing आहे. प्रत्यक्ष वापरातील मुख्य फरक migration path हा आहे. January 2025 मधील Forgejo v10.0 हा Gitea database थेट स्वीकारू शकणारा शेवटचा release होता आणि तोही Gitea v1.22 किंवा त्यापूर्वीच्या आवृत्तीपासूनच. त्यामुळे सध्याच्या Gitea instance वर supported in-place switch उपलब्ध नाही.
Self-hosted Git server वर GitHub Actions workflows चालवता येतील का?
Forgejo Actions आणि Gitea Actions दोन्ही GitHub Actions YAML syntax मध्ये लिहिलेले workflows चालवतात. ते .forgejo/workflows आणि .gitea/workflows मधून वाचले जातात. स्वतंत्र runner program install करून तो तुमच्या instance विरुद्ध register करावा लागतो. प्रकाशित केलेले अनेक actions कोणताही बदल न करता चालतात. Runner तुमच्या repositories मधील arbitrary code execute करतो आणि नेहमीच्या container labels सह प्रत्येक job साठी एक container सुरू करतो. त्यामुळे त्यासाठी स्वतंत्र host द्या किंवा किमान स्वतंत्र unprivileged user वापरा. तसेच तो आधीपासून forge चालवत असलेल्या 1 GB सर्व्हरवर ठेवू नका.
Self-hosted Git server चा backup कसा घ्यावा?
Bare repositories साठी, दुसऱ्या मशीनवरून 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 install असल्यास हीच command container च्या आत चालवा. Archive सर्व्हरबाहेर copy करा. प्रक्रिया योग्यरीत्या काम करते याची खात्री करण्यासाठी एकदा ते spare machine वर restore करा.