Self-hosted Git server: Forgejo, Gitea o cgit
Ihambing ang 4 na paraan ng pagpapatakbo ng Git server ayon sa RAM: SSH bare repos, cgit, Forgejo o Gitea, at GitLab. Alamin kung alin ang kaya ng 1 GB VPS.
Aling self-hosted Git server ang dapat mong patakbuhin
Hindi iisang produkto ang self-hosted Git server, at ang RAM (random access memory) ng iyong VPS ang nagtatakda kung aling bersyon nito ang kaya mong patakbuhin. Hindi nangangailangan ang Git ng sarili nitong daemon: gumaganang server na agad ang isang bare repository kasama ng SSH (secure shell) account sa pinakamaliit na server na maaari mong arkilahin. Ang lahat ng lampas dito ay isang web application na pinipili mong patakbuhin kasabay nito, at bawat pagtaas ng antas ay nangangailangan ng memory na maaaring wala sa isang maliit na VPS. Kung hindi mo pa rin tiyak kung saan nagtatapos ang Git at nagsisimula ang GitHub, inilalahad ng pagkakaiba ng Git, GitHub, at sarili mong Git server ang paghahating iyon bago ka pumili ng tier.
May apat na antas. Bare repository sa pamamagitan ng SSH, na walang bagong nakikinig na serbisyo. cgit, isang mabilis na read-only web view na walang database. Forgejo o Gitea, isang ganap na forge na may mga account, issue, at pull request sa ilang daang megabyte. GitLab, na nangangailangan ng server na maraming beses na mas malaki kaysa sa iba.
Magpasya batay sa gawaing kailangan mong gawin, pagkatapos ay ihambing ang memory figure sa planong binabayaran mo.
Gaano karaming RAM ang talagang kailangan ng bawat option
Dalawa lamang sa mga proyektong ito ang naglalabas ng hardware figure. Ituring ang inilathalang figure bilang minimum requirement, hindi bilang garantiya. Sukatin ang sarili mong instance kapag tumatakbo na ito gamit ang systemd-cgtop o ps -o rss= -C forgejo.
Ang datos sa likod ng tsart na ito
[
{
"label": "Gitea, small team",
"ram_gb": 1
},
{
"label": "GitLab, memory constrained",
"ram_gb": 8
},
{
"label": "GitLab, single node baseline",
"ram_gb": 16
}
]Nakadokumento sa Gitea na karaniwang sapat ang 1 GB na RAM kasama ang 2 CPU core para sa maliliit na team at proyekto. Binabanggit din nito na sapat ang Raspberry Pi 3 para sa maliliit na workload. Nakadokumento naman sa GitLab ang 16 GB bilang baseline para sa single-node installation, at 8 GB bilang pinakamababang antas para sa tinatawag ng sarili nitong page na memory constrained environment. Walang RAM figure ang installation documentation ng Forgejo. Fork ito ng Gitea at katulad nito ang behavior, kaya ang figure ng Gitea ang pinakamalapit na published guide na mayroon ka.
Ano ang ibig sabihin nito sa isang 1 GB VPS: kasya ang bare repositories at cgit na may natitirang resources, dahil walang resident service na pinapatakbo ang alinman sa mga ito. Magsisimula ang Forgejo o Gitea at makapagsisilbi ito sa isang maliit na team gamit ang SQLite, pero nasa dokumentadong minimum ka na. Kaya huwag patakbuhin sa server na iyon ang PostgreSQL at ang CI (continuous integration) runner. Kung biglang mawala ang web interface nang walang error, patakbuhin ang sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' at hanapin ang linyang tulad ng Out of memory: Killed process 1181 (forgejo). Ibig sabihin nito, pinatay ito ng kernel out-of-memory killer. Ang GitLab sa isang 1 GB server ay hindi malulutas sa pag-tune. Hindi ito tatakbo.
Tier 0: bare repository sa SSH
Walang network daemon ang Git na kailangan mong simulan. Ang git push sa SSH ay nagpapatakbo ng git-receive-pack sa remote host bilang ordinaryong Unix process, kaya anumang account na maaabot mo gamit ang key ay isa nang Git remote. Gumawa ng isang account para sa mga repository, at panatilihin ang mga repository sa labas ng home directory nito upang hindi kailangang magkaroon ng access sa home directory na iyon ang web view na idaragdag sa hinaharap.
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.gitGumagawa ang --bare ng repository na walang working copy. Ito ang uri ng repository na hinahawakan ng server. Bilang default, tinatanggihan ang pag-push sa checked-out branch ng repository na may working copy gamit ang refusing to update checked out branch: refs/heads/main. Ito ang pinakakaraniwang pagkakamali sa tier na ito.
Ngayon, bigyan ng key ang account at i-clone ang repository.
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 mainNagtatapos sa * [new branch] main -> main ang unang push na matagumpay. Ang push na nagtatapos sa git@vps.example.com: Permission denied (publickey) ay hindi kailanman na-authenticate, kaya basahin ang server log gamit ang sudo journalctl -u ssh -n 20. Ang linyang may Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys ay nangangahulugang mali ang ownership o file mode, dahil tinatanggihan ng sshd ang key file na may hindi pinagkakatiwalaang owner o mga permission na nagpapahintulot sa ibang user na sumulat dito.
Kung nakaturo na sa GitHub ang origin ng proyekto, hihinto ang git remote add origin sa error: remote origin already exists.. Sa pamamagitan ng pagdaragdag sa server na ito bilang pangalawang push URL sa remote na iyon, magagawa ng isang git push na i-update ang dalawa.
Pagkatapos, alisin ang shell access sa account.
command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" gitTumatanggap lamang ang git-shell ng ilang command na ipinapadala ng Git sa SSH. Kaya ang interactive login ay hihinto na ngayon na may mensahe sa halip na prompt:
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.Iyon na ang buong server. Walang database at walang web process na kailangang i-upgrade. Ang mawawala sa iyo ay ang lahat ng feature na ibinibigay ng forge: walang browsing, issue tracker, pull request, o per-user permission. Ang bawat key sa file na iyon ay makakabasa at makakasulat sa bawat repository na pagmamay-ari ng git user.
Tier 1: Nagbibigay ang cgit ng web view nang walang database
Ang cgit ay isang CGI (common gateway interface) program na nakasulat sa C. Pinapatakbo ito ng web server nang isang beses sa bawat request, direktang binabasa nito ang mga repository mula sa disk, at wala itong sariling state na iniimbak. Kasama ito sa universe component ng Ubuntu 24.04.
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitIturo ito sa directory ng repository sa /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/gitIni-scan ng scan-path ang directory na iyon at inililista ang bawat repository na makita nito, kaya lumilitaw ang bagong bare repo nang walang karagdagang configuration. Ang cache-size ang bilang ng mga naka-cache na page, at nananatiling naka-off ang caching kapag zero ito. Basahin muna ang inilagay na ng package sa /etc/cgitrc bago magdagdag ng mga linya, dahil may sarili nang mga default ang Debian at Ubuntu package.
Ipinapakita ng bawat entry ang unang linya ng description file ng repository, kaya inililista ng bagong bare repo ang sarili nito bilang Unnamed repository; edit this file 'description' to name the repository. Ayusin ito nang isang beses sa bawat repository:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionAng nginx site file at kung paano ito suriin
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 ListenInihahatid ng root /usr/share/cgit ang cgit.css at cgit.png bilang mga plain file, at ipinapasa ng try_files ang lahat ng iba pa sa CGI sa /usr/lib/cgit/cgit.cgi. Ang 502 page na may connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) sa /var/log/nginx/error.log ay nangangahulugang hindi tumatakbo ang socket unit o nakikinig ito sa ibang path. Ipinapakita ng systemctl show line ang aktuwal na path na ginagamit nito.
May dalawang limitasyong dapat malaman bago mo ito gamitin bilang pundasyon. Read-only ang cgit at walang login sa configuration na ito, kaya public ang lahat ng nasa ilalim ng scan-path: huwag maglagay ng private repository sa directory na iyon, o maglagay ng HTTP basic authentication sa harap ng buong site. Tumatakbo rin ang CGI bilang web server user, kaya kailangan ng user na iyon na makapasok sa /srv/git at mabasa ang bawat repository. Kapag hindi nito mapasok ang isang directory, lumilitaw ito bilang walang laman na index sa halip na magpakita ng error.
Tier 2: Forgejo o Gitea para sa issues at pull requests
Pareho ang pangunahing konsepto ng Forgejo at Gitea: isang Go binary na naghahatid ng web forge na may users, organisations, issues, pull requests, releases, package registry, at built-in CI system. Ang binary at SQLite ang buong installation, kaya kasya ang mga ito sa hardware na hindi kayang patakbuhin ang GitLab. Ang Compose file sa ibaba ay mula sa Forgejo documentation, kasama ang image tag na tinutukoy nito noong 24 October 2026.
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'Nasa v17 line ang 17 tag. Ang Forgejo v17.0.1, na inilabas noong 26 October 2026, ang kasalukuyang stable release, at may suporta ang Forgejo sa v17 hanggang 28 January 2027. Nawala ang suporta sa mas lumang v16 line noong 29 October 2026, kaya kailangan nang i-upgrade ngayon ang existing install na gumagamit pa ng 16 tag. Manual upgrade ang paglipat mula sa isang major version papunta sa kasunod nito, kaya mas praktikal na magsimula sa kasalukuyang version.
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1Dapat mag-print ang curl line ng HTTP status line. Bago makumpleto ang first-run setup, maaaring redirect ito sa /install, na nangangahulugang umaandar pa rin ang service. Kung lalabas naman ang container, ownership ang karaniwang sanhi: dapat pagmamay-ari ng UID (user id) sa USER_UID ang ./forgejo directory, kung hindi ay hindi maisusulat ng process ang sarili nitong data directory. Ipinaliliwanag nang buo sa Docker Compose sa isang VPS ang file layout na ito at ang volume ownership rule.
Dalawang sagot sa setup page ang nagtatakda kung gagana ang clone URLs. Dapat ang SSH port ay host side ng SSH mapping. Sa Compose file sa itaas, ito ay 222, dahil mina-map nito ang host port 222 sa port 22 ng container. Walang espesyal na requirement sa 222: gagana ang anumang available na host port, basta magkatugma ang mapping at ang sagot na ito. Dapat ding ang domain ay ang pangalang aktuwal na ita-type ng mga user. Kapag mali ang alinman sa dalawa, lahat ng repository page ay mag-aalok ng clone command na mabibigo para sa sinumang kokopya nito. Nasa [server] section ng app.ini ang dalawang setting pagkatapos, bilang SSH_PORT, SSH_DOMAIN, at ROOT_URL.
Para sa public instance, i-publish lamang ang web port sa loopback address ('127.0.0.1:3000:3000'), at gumamit ng nginx sa harap nito para sa TLS (transport layer security). Pareho ring ini-install ang Gitea mula sa docker.gitea.com/gitea image na ginagamit ng documentation nito, o bilang single binary na may isang systemd unit at isang app.ini. Ang kasalukuyang stable release nito ay v28.4.0, na inilabas noong 15 November 2026. Kasabay ng v28.0.0 sa katapusan ng September, inalis ng project ang dating 1. prefix, kaya 28, hindi 1.28, ang release pagkatapos ng 1.27.
Manatili sa SQLite hangga't maaari. Isang process at isang file lamang ang kailangan nito, at nagpapatuloy itong gumana pagkatapos ng reboot nang walang karagdagang service na kailangang i-supervise. Sulit ang PostgreSQL kapag sabay-sabay na nagsusulat ang maraming tao, dahil sini-serialize ng SQLite ang writes at patuloy na nagsusulat ang mahahabang CI run. Maaaring ilipat ng parehong project ang existing instance sa PostgreSQL sa ibang pagkakataon, kaya hindi ito desisyong hindi na mababago.
Forgejo o Gitea: ano talaga ang pagkakaiba
Magkapareho ang pinagmulan ng mga ito. Nag-fork ang Gitea mula sa Gogs noong 2016. Noong huling bahagi ng 2022, nailipat sa isang kumpanya, ang Gitea Ltd, ang control sa Gitea domain at trademark, at sinimulan ng ilang maintainer kasama ng Codeberg ang Forgejo. Binubuo ng community nito ang Forgejo sa ilalim ng umbrella ng Codeberg e.V., isang non-profit association na nakarehistro sa Germany at may hawak ng domains ng project, habang nananatili sa sarili nitong contributors ang governance ng Forgejo. Lumipat ito mula sa MIT licence patungo sa GPLv3 (GNU general public license version 3) noong 2024. Nanatiling MIT licensed ang Gitea at binubuo ito na may commercial backing.
Magkalapit ang feature sets nila sa pang-araw-araw na paggamit. Hindi ganoon kadali ang paglipat mula sa isa patungo sa isa. Ang Forgejo v10.0, mula January 2025, ang huling release na maaaring direktang gumamit ng Gitea database, at Gitea v1.22 o mas luma lamang ang suportado. Nasa v28.4.0 na ang Gitea noong 16 November 2026, kaya walang supported in-place switch ang kasalukuyang Gitea instance papunta sa Forgejo. Pumili ng isa bago ito punuin ng data, at ituring ang anumang paglipat sa hinaharap bilang export at re-import.
Maikling tuntunin sa pagpili: kung mahalaga sa iyo ang governance, o gusto mo ng project sa ilalim ng non-profit umbrella, gamitin ang Forgejo. Kung gusto mo ng mas malaking install base at commercial support option, gamitin ang Gitea. Parehong open ang development ng mga ito at madalas silang naglalabas ng release: naglalabas ang Forgejo ng stable release bawat tatlong buwan at ng LTS (long term support) release bawat taon. Ang v17.0.1 ang kasalukuyang release at ang v15.0.11 ang LTS noong 29 October 2026. Sinusuportahan ng Forgejo ang v17 hanggang 28 January 2027 at ang v15 hanggang 15 July 2027, habang nagtapos ang suporta sa v16 noong 29 October 2026. Kaya suriin ang releases page nito bago mag-pin ng major version. Kung hindi sapat ang alinmang tuntunin, inilalatag sa buong paghahambing ng Forgejo at Gitea kung paano nagkakaiba ang Actions at package registries nila. Iyan ang detalyeng dapat ayusin bago maging magastos ang paglipat dahil sa dami ng data.
Tier 3: magkano ang kinakailangan ng GitLab bago ito gumana
Ibang uri ng software ang GitLab CE. Ang isang instance ay binubuo ng magkakaugnay na serbisyo: Puma para sa web application, Sidekiq para sa background jobs, PostgreSQL, Redis, Gitaly para sa repository access, at nginx sa unahan. Ini-install silang magkakasama ng Omnibus package, kaya simple ang installation ngunit mataas ang minimum na memory requirement.
Nakadokumento sa requirements page ng GitLab ang 16 GB ng RAM at 8 vCPU bilang baseline para sa single-node installation. Nakasaad din doon ang 8 GB bilang pinakamababang halaga para sa environment na limitado ang memory. Sinasabi rin ng parehong page na i-disable ang swap, dahil malaki ang ibinabagsak ng performance ng instance kapag nag-swap ito habang may load. Ito ang mga inilathalang figure noong October 2026. Tumaas ang mga ito sa paglipas ng mga taon, kaya basahin muli ang page bago magtakda ng laki ng server.
May makukuha kang aktuwal na functionality kapalit ng resource budget na iyon: container registry, package registry, mas detalyadong permissions, at CI na nasubukan sa malalaking deployment. Nangangailangan ng bayad na GitLab tier ang compliance center at ang audit trail para sa project o group. Kung walang makapagsabi sa team mo ng feature mula sa listahang iyon na kailangan nila ngayong quarter, nagbabayad ka para sa mas malaking VPS nang walang napapala.
Modelo ng SSH access: isang git user at maraming key
Sa system OpenSSH, pare-pareho ang paraan ng authentication sa bawat tier dito. May isang Unix account na may pangalang git, at inilalagay ang bawat public key sa ~/.ssh/authorized_keys ng account na iyon. Ang key ang ginagamit para sa authentication. Ang authorization ay nakadepende sa mga option na inilalagay mo bago ang key sa parehong linya.
Ang simpleng linya ng key ay nagbibigay sa may hawak nito ng lahat ng maaaring gawin ng account. Para sa account na gumagamit pa rin ng /bin/bash bilang login shell, nililimitahan ito ng forced command sa Git:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptopSa isang salita, hindi pinapagana ng restrict, na available mula pa sa OpenSSH 7.2, ang port forwarding, agent forwarding, X11, at paglalaan ng PTY (pseudo terminal). Pinapalitan ng command= ang command na hinihiling ng client ng command na tinukoy mo, at gumagana pa rin ang Git dahil inilalagay ng SSH server ang orihinal na command ng client sa $SSH_ORIGINAL_COMMAND.
Awtomatikong ginagawa ng forge ang file na iyon para sa iyo. Iyan ang tunay na pagkakaiba ng tier 0 at tier 2. Kapag gumagamit ang mga ito ng system OpenSSH server, na siyang default nila, nire-rewrite ng Forgejo at Gitea ang authorized_keys gamit ang tig-isang linya para sa bawat nakarehistrong key. May forced command ang bawat linya na tumutukoy sa key gamit ang database id nito:
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 aliceSa pamamagitan ng forced command na iyon, nagkakaroon ng magkakahiwalay na permission ang bawat user kahit iisang Unix account ang ginagamit. Sinasabi ng key-3 sa forge kung sinong user ang kumokonekta, at sinusuri nito ang user laban sa repository bago mailipat ang anumang object. Huwag mano-manong i-edit ang file na iyon sa box na pinamamahalaan ng forge, dahil nire-rewrite ito mula sa database at mawawala ang idinagdag mong linya. Kung i-on mo ang built-in SSH server ng forge, o hihilingin sa OpenSSH ang mga key mula sa forge gamit ang AuthorizedKeysCommand, hindi na kailangan ng forge ang file na iyon. Sa ikalawang sitwasyon, parehong sinasabi ng dalawang project na i-off ang paglikha nito. Galing din sa parehong mechanism ang deploy key: ordinaryong SSH key ito na nakarehistro sa isang repository lang, karaniwang read-only, at sa forge ginagawa ang pagsusuri sa halip na sa sshd.
Mas mahalaga kaysa sa alinman sa configuration sa itaas ang dalawang gawi. Gumamit ng isang key para sa bawat tao o bawat machine, at huwag gumamit ng shared key, dahil kapag kailangan mong bawiin ang shared key, kailangan mo itong palitan para sa lahat nang sabay-sabay. Alisin din ang mga key sa araw na umalis ang isang tao, dahil ang lumang key na nananatili sa file ay permanenteng login na walang nagmo-monitor. Sinasaklaw ng Wastong pamamahala ng SSH key sa isang server ang mga uri ng key at passphrase, at pareho itong naaangkop dito. Kung bago ang box, ang unang sampung minuto sa isang bagong VPS ang dapat mong gawin bago maglagay ng mga repository rito.
Maaari ba akong magpatakbo ng GitHub Actions sa sarili kong Git server?
Maaari kang magpatakbo ng mga workflow na nakasulat sa syntax ng GitHub Actions. Hindi mo maaaring patakbuhin ang GitHub. Naka-enable bilang default ang Forgejo Actions mula pa noong Forgejo v1.21 at binabasa nito ang mga workflow file mula sa .forgejo/workflows sa bawat repository. Pareho ang paraan ng paggana ng Gitea Actions at binabasa nito ang .gitea/workflows. Pareho silang nangangailangan ng pangalawang program, ang runner, na kailangang i-install at i-register sa iyong instance gamit ang token mula sa admin settings. Maraming published action ang gumagana nang walang pagbabago.
Magplano para sa dalawang epekto. Gamit ang karaniwang container labels, nagsisimula ang runner ng container para sa bawat job. Dahil dito, kailangan nito ng sariling container engine at memory budget. Ito ang dahilan kung bakit hindi ito dapat ilagay sa parehong 1 GB na server ng forge. Maaari ring magpatakbo ang parehong runner ng mga job nang direkta sa host, gamit ang label na nagtatapos sa :host sa Forgejo. Hindi ito nangangailangan ng engine, ngunit wala ring container sa pagitan ng job at ng machine na iyon. Isinasagawa rin ng runner ang anumang nakasaad sa workflow file. Tahasang sinasabi ito sa dokumentasyon ng Forgejo: ang runner ay nagsasagawa ng remote code execution. Kung maaari, bigyan ito ng sariling host. Kung hindi, gumamit man lang ng sarili nitong unprivileged user at registration token na naka-scope sa isang repository.
Kung mananatili sa GitHub ang iyong mga repository at gusto mo lamang gamitin ang compute sa hardware na kontrolado mo, ibang setup ito na may ibang mga hakbang: ang sariling GitHub Actions runner ay kumokonekta sa isang GitHub repository at hindi nangangailangan ng alinman sa mga ito. Kung pinag-iisipan mo pa kung magkano ang kapalit ng pag-alis, ipinapakita ng mga aktuwal na ibinibigay ng GitHub ang pagkakaiba ng Git hosting at ng network na nakapaligid dito.
Mga Backup: kalahati lamang ng state ang repositories
Ang bare repository ay isang directory, kaya kapag kinopya ito, nakokopya ang lahat ng laman nito. Ang mirror clone mula sa ibang machine ay isang totoong backup, at nire-refresh nito ang repository sa kasalukuyang lokasyon:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updateKinukuha nito ang bawat ref at bawat object. Hindi nito kinukuha ang server-side hooks o ang description file, kaya magtabi rin ng file-level copy ng directory kung gumagamit ka ng hooks.
Iniimbak ng forge sa database nito ang issues, pull requests, users, keys, at permissions. Kapag repositories lamang ang kinopya, mawawala ang lahat ng iyon. May dump command ang parehong project na nagsusulat ng database, repositories, configuration, at attachments sa isang archive:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipSa Docker, tumatakbo ang parehong command sa loob ng container. Nagkakaiba ang configuration path depende sa image, kaya suriin muna ito bago mag-type:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniPatakbuhin ito bilang user na nagmamay-ari ng data. Isulat ang archive sa directory na maaaring sulatan ng user na iyon. Pagkatapos, kopyahin ang archive palabas ng server. Ang backup na nasa machine lamang na bina-back up ay hindi backup. Ang pag-restore ang hakbang na madalas nilalaktawan. I-unpack ngayon ang isang dump sa isang spare box para matutuhan mo ang procedure sa mahinahong panahon, sa halip na habang may outage.
Pumili ayon sa sitwasyon
Isang tao na may laptop at VPS, at hindi nangangailangan ng web browsing: bare repositories sa SSH. Walang karagdagang service na tumatakbo at walang kailangang i-upgrade.
Pareho sa itaas, pero gusto mong magbasa ng code sa browser at magpadala ng mga link dito: idagdag ang cgit. Wala pa ring database at wala pa ring resident service.
Isang team na nagre-review ng code ng isa't isa at sumusubaybay sa mga issue: Forgejo o Gitea, sa server na may 2 GB RAM o higit pa. Ilipat ang CI runner sa pangalawang machine kapag naging seryoso na ang mga job.
Isang organisasyon na nangangailangan ng container registry at audit trail, at may 16 GB na budget para sa server: GitLab. Kung mas mababa sa budget na ito, huwag itong simulan.
Mura ang pag-akyat sa unang tatlong tier dahil sa lahat ng ito, ordinaryong Git directory sa disk ang mga repository. Magsimula sa pinakamababang tier na kayang tumugon sa pangangailangan. Kung tinutukoy mo kung ano pa ang karapat-dapat bigyan ng space sa parehong server, inilalagay ng shortlist ng mga serbisyong sulit i-self-host ang Git server kasama ng iba pang serbisyong nakikipagkumpitensya para sa RAM na iyon.
FAQ
Makapagpapatakbo ba ang isang 1 GB VPS ng Forgejo o Gitea?
Oo, para sa maliit na team, gamit ang SQLite, at walang ibang mabigat na workload sa server. Ayon sa documentation ng Gitea, karaniwang sapat ang 1 GB ng RAM at 2 CPU core para sa maliliit na team at proyekto, at ang Forgejo ay fork ng Gitea na may kaparehong resource profile. Huwag magdagdag ng PostgreSQL o CI runner sa machine na iyon. Kung biglang nawawala ang serbisyo nang walang error sa sarili nitong log, patakbuhin ang sudo dmesg -T | grep -Ei 'oom|out of memory|killed process': kapag may linyang naglilista ng prosesong pinatay, kinuha ito ng kernel out-of-memory killer, kaya mas malaking plan ang kailangan sa halip na tuning flag.
Ano ang pagkakaiba ng Forgejo at Gitea?
Magkapareho ang pinagmulan ng kanilang codebase at karamihan ng mga feature. Nag-fork ang Gitea mula sa Gogs noong 2016, at nag-fork ang Forgejo mula sa Gitea noong huling bahagi ng 2022 matapos mapunta sa isang kumpanya ang kontrol sa trademark ng Gitea. Binubuo ang Forgejo ng komunidad nito sa ilalim ng Codeberg e.V., isang non-profit sa Germany, at nire-release sa ilalim ng GPLv3; nananatiling MIT-licensed ang Gitea at may commercial backing. Ang praktikal na pagkakaiba ay ang migration path. Ang Forgejo v10.0, mula Enero 2025, ang huling release na maaaring direktang gumamit ng Gitea database, at mula lamang sa Gitea v1.22 o mas luma. Dahil dito, walang suportadong in-place switch para sa kasalukuyang Gitea instance.
Maaari ba akong magpatakbo ng GitHub Actions workflow sa self-hosted Git server?
Ang Forgejo Actions at Gitea Actions ay parehong nagpapatakbo ng workflow na nakasulat sa GitHub Actions YAML syntax at binabasa mula sa .forgejo/workflows at .gitea/workflows. Mag-install ka ng hiwalay na runner program at i-register ito sa iyong instance. Maraming published action ang gumagana nang walang pagbabago. Nagpapatakbo ang runner ng arbitrary code mula sa iyong repository at, gamit ang karaniwang container label, nagsisimula ng container para sa bawat job. Kaya ilagay ito sa sarili nitong host, o kahit sa sarili nitong unprivileged user, at huwag itong ilagay sa 1 GB server na nagpapatakbo na ng forge.
Paano ako magba-back up ng self-hosted Git server?
Para sa bare repository, kinokopya ng git clone --mirror mula sa ibang machine ang bawat ref at object, at nire-refresh ito ng git remote update sa loob ng mirror. Para sa Forgejo o Gitea, bahagi lamang ng state ang repository dahil nasa database ang issues, pull request, user, at key. Gamitin ang built-in dump na sudo -u git forgejo dump -c /etc/forgejo/app.ini, o gamitin ang parehong command sa loob ng container para sa Docker install. Kopyahin ang archive palabas ng server, at isang beses itong i-restore sa ekstrang machine upang matiyak mong gumagana ang procedure.