SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor · Imeboreshwa 2026-11-07

Seva ya Git ya kujiendeshea: Forgejo, Gitea au cgit?

Chagua seva ya Git kulingana na RAM ya VPS yako. Linganisha matumizi ya kumbukumbu kwa bare repos, cgit, Forgejo, Gitea na GitLab ili kuona kinachofaa kwenye 1 GB RAM.

Ni seva ipi ya Git unayopaswa kujiendeshea mwenyewe

Seva ya Git unayojiendeshea mwenyewe si bidhaa moja tu, na kiasi cha RAM (random access memory) kwenye VPS yako ndicho huamua ni toleo lipi unaweza kulitumia. Git haihitaji daemon yake yenyewe: bare repository pamoja na akaunti ya SSH (secure shell) ni seva inayofanya kazi tayari kwenye mashine ndogo zaidi unayoweza kukodisha. Kila kitu kilicho juu ya kiwango hicho ni programu ya wavuti unayochagua kuiendesha kando yake, na kila hatua ya juu inagharimu kumbukumbu ambayo VPS ndogo inaweza isiwe nayo. Ikiwa bado huna uhakika Git inaishia wapi na GitHub inaanza wapi, jinsi Git, GitHub na seva yako ya Git zinavyotofautiana inaweka wazi mgawanyo huo kabla ya kuchagua ngazi yako.

Kuna hatua nne. Bare repository kupitia SSH, bila kitu chochote kinachosikiliza ambacho hakikuwa kikisikiliza hapo awali. cgit, mwonekano wa wavuti wa haraka wa kusoma pekee bila database. Forgejo au Gitea, jukwaa kamili lenye akaunti, masuala (issues) na pull requests ndani ya megabytes mia chache. GitLab, ambayo inahitaji seva kubwa mara nyingi zaidi kuliko nyingine.

Amua kulingana na kazi unayohitaji kufanya, kisha linganisha kiasi cha kumbukumbu na mpango unaolipiwa.

Kiasi cha RAM kinachohitajika kwa kila chaguo

Miradi miwili pekee kati ya hii ndiyo inayochapisha takwimu za maunzi. Ichukulie takwimu iliyochapishwa kama kiwango cha chini kabisa badala ya ahadi, na upime mfano wako (instance) pindi unapoanza kufanya kazi, kwa kutumia systemd-cgtop au ps -o rss= -C forgejo.

ChatiRAM the projects document, official docs, October 2026
Data iliyo nyuma ya chati hii
[
  {
    "label": "Gitea, small team",
    "ram_gb": 1
  },
  {
    "label": "GitLab, memory constrained",
    "ram_gb": 8
  },
  {
    "label": "GitLab, single node baseline",
    "ram_gb": 16
  }
]

Gitea inaandika 1 GB ya RAM ikiwa na CPU cores 2 kama kiasi kinachotosha kwa timu ndogo na miradi, na inataja Raspberry Pi 3 kama kifaa kinachotosha kwa kazi ndogo. GitLab inaandika 16 GB kama msingi wa usakinishaji wa node moja, na 8 GB kama kiwango cha chini kabisa kwa kile ukurasa wake unachokiita mazingira yenye uhaba wa kumbukumbu. Nyaraka za usakinishaji wa Forgejo hazitoi takwimu yoyote ya RAM. Ni fork ya Gitea na hufanya kazi kama hiyo, kwa hivyo takwimu ya Gitea ndiyo mwongozo wa karibu zaidi uliopo.

Hii inamaanisha nini kwenye VPS ya 1 GB: bare repositories na cgit vinafaa na bado nafasi inabaki, kwa sababu hakuna kati ya hizo inayoendesha huduma ya kudumu (resident service). Forgejo au Gitea itaanza na itahudumia timu ndogo kwenye SQLite, lakini kwa kuwa uko kwenye kiwango cha chini kilichoandikwa, basi usisakinishe PostgreSQL na CI (continuous integration) runner kwenye seva hiyo. Ikiwa kiolesura cha wavuti kitatoweka bila kutoa kosa, endesha sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' na utafute mstari kama Out of memory: Killed process 1181 (forgejo), ambao unamaanisha kuwa kernel out of memory killer imeifunga huduma hiyo. GitLab kwenye seva ya 1 GB si tatizo la kurekebisha (tuning). Haitafanya kazi.

Tier 0: hazina (repository) ya msingi kupitia SSH

Git haina daemon ya mtandao unayopaswa kuanzisha. git push kupitia SSH huendesha git-receive-pack upande wa pili kama mchakato wa kawaida wa Unix, kwa hivyo akaunti yoyote unayoweza kufikia kwa kutumia key tayari ni Git remote. Tengeneza akaunti moja kwa ajili ya hazina hizo, na uweke hazina hizo nje ya saraka yake ya nyumbani (home directory) ili mtazamo wa wavuti (web view) utakaoongezwa baadaye usihitaji kufikia saraka hiyo ya nyumbani.

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 hutengeneza hazina bila nakala ya kufanyia kazi (working copy), ambayo ndiyo inayopaswa kuwepo kwenye seva. Kusukuma (push) mabadiliko kwenye branch iliyofunguliwa ya hazina yenye working copy hukataliwa na mfumo kwa chaguo-msingi kwa kutumia refusing to update checked out branch: refs/heads/main, na hilo ndilo kosa la kawaida zaidi katika ngazi hii.

Sasa ipatie akaunti hiyo key na uifanye 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_keys
git remote add origin git@vps.example.com:/srv/git/project.git
git push -u origin main

Push ya kwanza iliyofanikiwa huishia na * [new branch] main -> main. Push inayoishia na git@vps.example.com: Permission denied (publickey) haikuidhinishwa, kwa hivyo soma log ya seva kwa kutumia sudo journalctl -u ssh -n 20. Mstari unaosomeka Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys unamaanisha kuwa umiliki au mode ya faili si sahihi, kwa sababu sshd hukataa faili ya key yenye mmiliki asiyeaminika au ruhusa zinazoruhusu watumiaji wengine kuiandika.

Ikiwa origin ya mradi tayari inaelekeza GitHub, git remote add origin husimama na error: remote origin already exists., na kuongeza seva hii kama URL ya pili ya push kwenye remote hiyo humruhusu mtu git push kusasisha zote mbili.

Kisha ondoa uwezo wa akaunti hiyo kutumia shell.

command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" git

git-shell hukubali tu amri chache ambazo Git hutuma kupitia SSH, kwa hivyo login ya maingiliano (interactive login) sasa husimama na ujumbe badala ya prompt:

fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.

Hiyo ndiyo seva nzima. Hakuna database, na hakuna mchakato wa wavuti wa kusasisha. Unachopoteza ni kila kitu ambacho jukwaa la usimamizi wa msimbo (forge) hutoa: hakuna kuvinjari, hakuna kifuatiliaji cha masuala (issue tracker), hakuna pull requests, na hakuna ruhusa kwa kila mtumiaji. Kila key iliyo kwenye faili hiyo inaweza kusoma na kuandika kila hazina inayomilikiwa na mtumiaji wa git.

Tier 1: cgit inakupa mwonekano wa wavuti bila database

cgit ni programu ya CGI (common gateway interface) iliyoandikwa kwa C. Seva ya wavuti huiendesha mara moja kwa kila ombi, inasoma hazina (repositories) moja kwa moja kutoka kwenye diski, na haihifadhi hali yoyote ya kwake yenyewe. Ubuntu 24.04 inayo kwenye sehemu ya universe.

sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgit

Ielekeze kwenye saraka ya hazina katika /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/git

scan-path hupitia saraka hiyo na kuorodhesha kila hazina inayoipata, kwa hivyo hazina mpya ya bare huonekana bila usanidi wa ziada. cache-size ni idadi ya kurasa zilizohifadhiwa kwenye cache, na caching hubaki imezimwa wakati thamani yake ni sifuri. Soma kile ambacho kifurushi chako tayari kimekiweka katika /etc/cgitrc kabla ya kuongeza mistari, kwa sababu kifurushi cha Debian na Ubuntu huja na chaguo-msingi zake.

Kila ingizo huonyesha mstari wa kwanza wa faili ya description ya hazina, kwa hivyo hazina mpya ya bare hujiorodhesha kama Unnamed repository; edit this file 'description' to name the repository. Rekebisha hilo mara moja kwa kila hazina:

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
Faili ya tovuti ya nginx, na jinsi ya kuiangalia
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 Listen

root /usr/share/cgit huhudumia cgit.css na cgit.png kama faili za kawaida, na try_files hukabidhi kila kitu kingine kwa CGI katika /usr/lib/cgit/cgit.cgi. Ukurasa wa 502, pamoja na connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) katika /var/log/nginx/error.log, inamaanisha kuwa kitengo cha socket hakijawashwa au kinasikiliza kwenye njia nyingine. Mstari wa systemctl show huchapisha njia inayotumika kihalisi.

Kuna mipaka miwili inayofaa kujulikana kabla ya kuijenga. cgit ni ya kusoma pekee (read-only) na haina sehemu ya kuingia (login) katika usanidi huu, kwa hivyo kila kitu chini ya scan-path ni cha umma: weka hazina ya faragha nje ya saraka hiyo, au weka HTTP basic authentication mbele ya tovuti nzima. Na CGI huendeshwa kama mtumiaji wa seva ya wavuti, kwa hivyo mtumiaji huyo anahitaji ruhusa ya kupita katika /srv/git na kusoma kila hazina. Saraka ambayo haiwezi kuingia huonekana kama index tupu badala ya kutoa kosa.

Ngazi ya 2: Forgejo au Gitea kwa issues na pull requests

Forgejo na Gitea zina wazo lilelile: binary moja ya Go inayotoa web forge yenye users, organisations, issues, pull requests, releases, package registry na mfumo wa CI uliojengeka ndani. Binary pamoja na SQLite ndiyo usakinishaji wote. Ndiyo sababu zinafaa kwenye hardware ambayo GitLab haiwezi kutumia. Faili ya Compose hapa chini ndiyo iliyoko kwenye documentation ya Forgejo, ikiwa na image tag inayotajwa humo kufikia 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'

Tag ya 17 inafuata mfululizo wa v17. Forgejo v17.0.1, iliyotolewa 26 October 2026, ndiyo stable release ya sasa, na Forgejo inasaidia v17 hadi 28 January 2027. Mfululizo wa zamani wa v16 uliacha kuungwa mkono tarehe 29 October 2026. Kwa hiyo, usakinishaji uliopo ambao bado unatumia tag ya 16 unapaswa kuboreshwa sasa. Kuhama kutoka major version moja hadi inayofuata baadaye ni manual upgrade. Kwa hiyo, ni nafuu kuanza na toleo la sasa.

docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1

Mstari wa curl unapaswa kuchapisha HTTP status line. Kabla hujakamilisha first-run setup, unaweza kupata redirect kwenda /install. Hilo bado linamaanisha kuwa service iko hewani. Ikiwa container inatoka badala yake, sababu ya kawaida ni ownership. Directory ya ./forgejo lazima iwe ya UID (user id) iliyo kwenye USER_UID. La sivyo, process haiwezi kuandika data directory yake. Docker Compose kwenye VPS inaeleza kikamilifu mpangilio huo wa mafaili na kanuni ya volume ownership.

Majibu mawili kwenye setup page huamua kama clone URLs zitafanya kazi. SSH port lazima iwe upande wa host wa SSH mapping. Kwenye Compose file hapo juu ni 222, kwa sababu inaunganisha host port 222 na port 22 ya container. Hakuna sharti la kutumia 222 yenyewe. Host port yoyote iliyo huru inafanya kazi, mradi mapping na jibu hili vilingane. Domain lazima iwe jina ambalo watu wataandika kweli. Ukikosea mojawapo, kila repository page itatoa clone command ambayo itashindwa kwa kila mtu atakayeinakili. Baadaye, yote hayo hupatikana kwenye section ya [server] ya app.ini, kama SSH_PORT, SSH_DOMAIN na ROOT_URL.

Kwa instance ya umma, publish web port kwenye loopback address pekee ('127.0.0.1:3000:3000'), kisha weka nginx mbele yake kwa TLS (transport layer security). Gitea husakinishwa kwa njia ileile kutoka kwenye image ya docker.gitea.com/gitea inayotumiwa kwenye documentation yake, au kama binary moja yenye systemd unit moja na app.ini moja. Stable release yake ya sasa ni v28.3.0, iliyochapishwa 1 November 2026. Kwa v28.0.0 mwishoni mwa September, project iliondoa prefix ya zamani ya 1.. Kwa hiyo, release inayofuata 1.27 ni 28, si 1.28.

Endelea kutumia SQLite mradi bado unaweza. Hii huweka instance kwenye process moja na file moja, na inastahimili reboot bila service ya ziada ya kusimamiwa. PostgreSQL inahalalisha gharama yake wakati watu kadhaa wanaandika kwa wakati mmoja, kwa sababu SQLite huweka writes kwenye foleni moja na CI runs ndefu huandika kila mara. Projects zote mbili zinaweza kuhamisha instance iliyopo kwenda PostgreSQL baadaye. Kwa hiyo, si uamuzi ambao utakwama nao.

Forgejo au Gitea: ni nini hasa hutofautiana

Asili yao inafanana. Gitea ilifork kutoka Gogs mwaka 2016. Mwishoni mwa 2022, udhibiti wa Gitea domain na trademark ulihamia kwa kampuni ya Gitea Ltd. Maintainers kadhaa pamoja na Codeberg wakaanzisha Forgejo. Forgejo inaendelezwa na community yake chini ya mwavuli wa Codeberg e.V., association isiyo ya kibiashara iliyosajiliwa nchini Germany na inayomiliki domains za project. Hata hivyo, governance inaendelea kuwa mikononi mwa contributors wa Forgejo. Mwaka 2024, ilihama kutoka MIT licence kwenda GPLv3 (GNU general public license version 3). Gitea inaendelea kutumia MIT licence na inaendelezwa ikiwa na commercial backing.

Katika matumizi ya kila siku, feature sets zinafanana kwa kiasi kikubwa. Njia ya kuhama kati yao haifanani. Forgejo v10.0, ya January 2025, ndiyo release ya mwisho iliyoweza kupokea Gitea database moja kwa moja, na hilo lilifanya kazi kutoka Gitea v1.22 au ya zamani zaidi pekee. Kufikia 2 November 2026, Gitea iko kwenye v28.3.0. Kwa hiyo, Gitea instance ya sasa haina supported in-place switch kwenda Forgejo. Chagua moja kabla hujaijaza data, na chukulia uhamisho wowote wa baadaye kama export na re-import.

Kanuni fupi ya kuchagua. Ikiwa utawala ni muhimu kwako, au unataka mradi ulio chini ya mwavuli wa shirika lisilo la faida, tumia Forgejo. Ikiwa unataka msingi mkubwa zaidi wa usakinishaji na chaguo la usaidizi wa kibiashara, tumia Gitea. Zote mbili hutunzwa kwa uwazi na hutoa matoleo mara kwa mara: Forgejo hutoa stable release kila baada ya miezi mitatu na LTS (long term support) release kila mwaka. Kufikia 29 October 2026, v17.0.1 ndiyo toleo la sasa na v15.0.11 ndiyo LTS. Forgejo inaendelea kusaidia v17 hadi 28 January 2027 na v15 hadi 15 July 2027, huku usaidizi wa v16 ukiisha 29 October 2026. Kwa hiyo, angalia ukurasa wake wa releases kabla ya kubandika major version. Ikiwa hakuna kanuni kati ya hizo inayotoa uamuzi, ulinganisho kamili wa Forgejo na Gitea unaeleza tofauti za Actions na package registries zao. Hilo ndilo jambo la kuamua kabla data yako haijafanya kubadilisha kuwa ghali.

Tier 3: gharama za GitLab kabla ya kuanza kufanya kazi

GitLab CE ni darasa tofauti la programu. Instance moja ni mkusanyiko wa huduma zinazoshirikiana: Puma kwa ajili ya programu ya wavuti, Sidekiq kwa ajili ya kazi za nyuma (background jobs), PostgreSQL, Redis, Gitaly kwa ajili ya ufikiaji wa repository, na nginx iliyowekwa mbele. Kifurushi cha Omnibus husakinisha huduma hizi pamoja, jambo linalorahisisha usakinishaji lakini likiweka kiwango cha chini cha kumbukumbu (RAM) kuwa kikubwa.

Ukurasa wa mahitaji ya GitLab unaelekeza 16 GB ya RAM na 8 vCPU kama msingi wa usakinishaji wa node moja, huku 8 GB ikitajwa kama kiwango cha chini kabisa katika mazingira yenye kumbukumbu finyu. Ukurasa huohuo unakushauri kuzima swap, kwa sababu kufanya swapping wakati wa mzigo mkubwa kunashusha utendaji wa instance vibaya sana. Hizo ni takwimu zilizochapishwa kufikia Oktoba 2026, na zimekuwa zikipanda kadiri miaka inavyokwenda, hivyo soma ukurasa huo tena kabla ya kuchagua ukubwa wa seva.

Unapata vitu vya kweli kwa bajeti hiyo: container registry, package registry, ruhusa zilizopangiliwa kwa usahihi, na CI ambayo imefanyiwa majaribio kwa kiwango kikubwa; kituo cha kufuata sheria (compliance center) na kumbukumbu za ukaguzi (audit trails) za mradi au kikundi vinahitaji tier ya GitLab ya kulipia. Ikiwa hakuna mtu katika timu yako anayeweza kutaja kitu kutoka kwenye orodha hiyo ambacho wanahitaji robo hii, unalipia VPS kubwa zaidi bila kupata faida yoyote.

Mfumo wa ufikiaji wa SSH: mtumiaji mmoja wa git na funguo nyingi

Katika OpenSSH ya mfumo, kila ngazi hapa hujitambulisha kwa njia ile ile. Kuna akaunti moja ya Unix inayoitwa git, na kila ufunguo wa umma (public key) huwekwa kwenye ~/.ssh/authorized_keys ya akaunti hiyo. Uthibitishaji (authentication) ni ufunguo wenyewe. Idhini (authorisation) ni chaguzi zozote unazoandika mbele ya ufunguo kwenye mstari mmoja.

Mstari wa ufunguo wa kawaida humpa mwenye ufunguo uwezo wowote ambao akaunti hiyo inao. Kwa akaunti inayotumia /bin/bash kama shell yake ya kuingia, amri ya lazima (forced command) huizuia akaunti hiyo kufanya kazi za Git pekee:

restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop

restrict, inayopatikana kuanzia OpenSSH 7.2, huzima usambazaji wa port (port forwarding), usambazaji wa wakala (agent forwarding), X11, na utengaji wa PTY (pseudo terminal) kwa neno moja. command= hubadilisha ombi lolote la mteja na amri unayotaja, na Git bado hufanya kazi kwa sababu seva ya SSH huweka amri asilia ya mteja ndani ya $SSH_ORIGINAL_COMMAND.

Mfumo wa forge huandika faili hiyo kwa ajili yako, na huo ndio utofauti halisi kati ya ngazi ya 0 na ngazi ya 2. Zinapokuwa nyuma ya seva ya OpenSSH ya mfumo, ambayo ndiyo chaguo-msingi, Forgejo na Gitea huandika upya authorized_keys kwa mstari mmoja kwa kila ufunguo uliosajiliwa, kila mmoja ukiwa na amri ya lazima inayotaja ufunguo kwa kutumia kitambulisho chake cha database:

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

Amri hiyo ya lazima ndiyo njia ambayo akaunti moja ya Unix iliyoshirikiwa inageuka kuwa idhini ya kila mtumiaji: key-3 huambia mfumo wa forge ni mtumiaji yupi anayeunganisha, na huangalia mtumiaji huyo dhidi ya hazina (repository) kabla ya kitu chochote kuhamishwa. Usihariri faili hiyo kwa mikono kwenye seva inayodhibitiwa na forge, kwa sababu huandikwa upya kutoka kwenye database na mstari wako utapotea. Ukianzisha seva ya SSH iliyojengwa ndani ya forge, au ukaifanya OpenSSH iulize forge funguo kupitia AuthorizedKeysCommand, forge haihitaji faili hiyo kabisa, na miradi yote miwili inakushauri kuzima uundaji wake katika hali ya pili. Funguo za deploy (deploy keys) hutoka kwenye utaratibu ule ule: ufunguo wa deploy ni ufunguo wa kawaida wa SSH uliosajiliwa kwa hazina moja, kwa kawaida wa kusoma pekee (read-only), huku ukaguzi ukifanywa ndani ya forge badala ya sshd.

Tabia mbili ni muhimu zaidi kuliko usanidi wowote hapo juu. Toa ufunguo mmoja kwa kila mtu au kila mashine, usiwahi kushiriki ufunguo mmoja, kwa sababu kubatilisha ufunguo ulioshirikiwa inamaanisha kuubadilisha kwa kila mtu kwa wakati mmoja. Na ondoa funguo siku mtu anapoondoka, kwa sababu ufunguo wa zamani kwenye faili hiyo ni njia ya kudumu ya kuingia ambayo hakuna anayeifuatilia. Usimamizi bora wa funguo za SSH kwenye seva inashughulikia aina za funguo na misemo ya siri (passphrases), na yote hayo yanatumika hapa bila mabadiliko. Ikiwa seva ni mpya, dakika kumi za kwanza kwenye VPS mpya ndilo jambo sahihi la kufanya kabla ya kuweka hazina juu yake.

Je, ninaweza kuendesha GitHub Actions kwenye seva yangu ya Git?

Unaweza kuendesha workflow zilizoandikwa kwa sintaksia ya GitHub Actions. Huwezi kuendesha GitHub yenyewe. Forgejo Actions imewezeshwa kwa chaguomsingi tangu Forgejo v1.21 na inasoma faili za workflow kutoka .forgejo/workflows katika kila hazina (repository). Gitea Actions inafanya kazi kwa njia ile ile na inasoma .gitea/workflows. Zote zinahitaji programu ya pili, yaani runner, ambayo inasakinishwa na kusajiliwa kwenye instance yako kwa kutumia token kutoka kwenye mipangilio ya msimamizi (admin settings). Actions nyingi zilizochapishwa hufanya kazi bila mabadiliko.

Panga kwa ajili ya matokeo mawili. Kwa kutumia lebo za kawaida za container, runner huanzisha container kwa kila job, kwa hivyo inahitaji injini ya container na bajeti yake ya kumbukumbu (memory), ndiyo maana haipaswi kuwekwa kwenye seva ile ile ya 1 GB inayotumika na forge. Runners zote mbili zinaweza pia kuendesha job moja kwa moja kwenye host, kupitia lebo inayoishia na :host kwenye Forgejo, ambayo haihitaji injini lakini pia haiweki container yoyote kati ya job na mashine hiyo. Na runner hutekeleza chochote kinachosemwa na faili ya workflow, jambo ambalo nyaraka za Forgejo zinalieleza wazi: runner hufanya remote code execution. Ipe host yake yenyewe inapowezekana, au angalau mtumiaji asiye na upendeleo (unprivileged user) na token ya usajili iliyowekewa mipaka kwa hazina moja pekee.

Ikiwa hazina zako zinabaki kwenye GitHub na unataka tu uwezo wa kompyuta (compute) kwenye maunzi unayoyadhibiti, huo ni usanidi tofauti wenye hatua tofauti: runner ya GitHub Actions inayojiendesha yenyewe (self-hosted) huunganishwa kwenye hazina ya GitHub na haihitaji yoyote kati ya haya. Ikiwa bado unapima gharama za kuhama, kile ambacho GitHub inakupa kihalisi kinatenganisha hosting ya Git na mtandao unaoizunguka.

Backups: repositories ni nusu tu ya hali ya mfumo

Bare repository ni saraka (directory), kwa hivyo kuinakili kunanakili kila kitu kilichomo. Mirror clone kutoka mashine nyingine ni backup halisi, na inajisasisha yenyewe mahali ilipo:

git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote update

Hiyo huvuta kila ref na kila object. Haivuti server-side hooks au faili ya description, kwa hivyo hifadhi nakala ya kiwango cha faili ya saraka hiyo pia ikiwa unatumia hooks.

Forge huhifadhi issues, pull requests, watumiaji, keys na ruhusa katika database yake, na nakala ya repositories pekee hupoteza yote hayo. Miradi yote miwili hutoa amri ya dump inayoandika database, repositories, configuration na viambatisho kwenye archive moja:

sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zip

Chini ya Docker amri hiyo hiyo huendeshwa ndani ya container, na njia ya configuration inategemea image, kwa hivyo angalia kabla ya kuandika:

docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.ini

Iendeshe kama mtumiaji anayemiliki data, na uandike archive kwenye saraka ambayo mtumiaji huyo anaweza kuandika. Kisha nakili archive hiyo nje ya seva, kwa sababu backup inayopatikana kwenye mashine inayochelezwa pekee si backup. Kurejesha (restoring) ni hatua ambayo watu huiruka: fungua dump moja kwenye mashine ya ziada sasa hivi, ili ujifunze utaratibu huo wakati wa utulivu badala ya wakati wa hitilafu.

Chagua kulingana na hali

Mtu mmoja mwenye laptop na VPS, bila kuhitaji kivinjari: tumia bare repositories kupitia SSH. Hakuna huduma ya ziada inayofanya kazi na hakuna cha kusasisha.

Hali hiyo hiyo, lakini unataka kusoma msimbo (code) kwenye kivinjari na kutuma viungo vyake: ongeza cgit. Bado hakuna database, na hakuna huduma inayokaa kwenye kumbukumbu (resident).

Timu inayokagua msimbo wa kila mmoja na kufuatilia masuala (issues): tumia Forgejo au Gitea, kwenye 2 GB ya RAM au zaidi. Hamisha CI runner kwenye seva ya pili pindi kazi (jobs) zinapokuwa nzito.

Shirika linalohitaji container registry na audit trails, likiwa na 16 GB ya RAM kwa ajili ya seva: tumia GitLab. Chini ya bajeti hiyo, usijaribu kuanzisha huduma hii.

Kupanda kutoka ngazi ya kwanza hadi ya tatu ni rahisi, kwa sababu katika zote hizo, repositories ni saraka za kawaida za Git kwenye diski. Anza na ngazi ya chini kabisa inayokidhi mahitaji yako. Ikiwa unatafakari ni nini kingine kinachostahili nafasi kwenye seva hiyo hiyo, orodha fupi ya huduma zinazofaa kwa self-hosting inaweka seva ya Git sambamba na huduma nyingine zinazogombea RAM hiyo.

FAQ

Je, VPS ya 1 GB inaweza kuendesha Forgejo au Gitea?

Ndiyo, kwa timu ndogo, ukitumia SQLite, na bila huduma nyingine nzito kwenye seva hiyo. Nyaraka za Gitea zinaeleza kuwa 1 GB ya RAM na 2 CPU cores kwa kawaida zinatosha kwa timu na miradi midogo, na Forgejo ni fork ya Gitea yenye muundo uleule. Usiongeze PostgreSQL au CI runner kwenye mashine hiyo. Ikiwa huduma itapotea bila kutoa error kwenye log yake, endesha sudo dmesg -T | grep -Ei 'oom|out of memory|killed process': mstari unaotaja mchakato uliositishwa (killed process) unamaanisha kuwa kernel out of memory killer imeifunga, na suluhisho ni kupata mpango mkubwa zaidi wa VPS badala ya kutafuta flag za kuboresha utendaji.

Kuna tofauti gani kati ya Forgejo na Gitea?

Zinashiriki historia ya codebase na vipengele vingi. Gitea ilitokana na Gogs mwaka 2016, na Forgejo ilitokana na Gitea mwishoni mwa 2022 baada ya udhibiti wa alama ya biashara ya Gitea kuhamishiwa kwa kampuni. Forgejo inatengenezwa na jamii yake chini ya mwamvuli wa Codeberg e.V., shirika lisilo la faida nchini Ujerumani, na kutolewa chini ya leseni ya GPLv3; Gitea inabaki na leseni ya MIT ikiwa na ufadhili wa kibiashara. Tofauti ya kiutendaji ni njia ya kuhama (migration path). Forgejo v10.0, ya Januari 2025, ilikuwa toleo la mwisho lililoweza kuchukua database ya Gitea moja kwa moja, na kutoka Gitea v1.22 au ya zamani zaidi pekee, kwa hivyo instance ya sasa ya Gitea haina njia ya moja kwa moja ya kubadili (in-place switch) inayoungwa mkono.

Je, ninaweza kuendesha workflow za GitHub Actions kwenye seva ya Git ninayojiendeshea mwenyewe?

Forgejo Actions na Gitea Actions zote huendesha workflow zilizoandikwa kwa syntax ya YAML ya GitHub Actions, zinazosomwa kutoka .forgejo/workflows na .gitea/workflows. Unasakinisha programu tofauti ya runner na kuisajili kwenye instance yako. Actions nyingi zilizochapishwa hufanya kazi bila mabadiliko. Runner huendesha code yoyote kutoka kwenye repositories zako na, kwa kutumia lebo za kawaida za container, huanzisha container moja kwa kila job, kwa hivyo ipe host yake yenyewe, au angalau mtumiaji asiye na upendeleo (unprivileged user), na uiweke mbali na seva ya 1 GB ambayo tayari inaendesha forge.

Ninafanyaje backup ya seva ya Git ninayojiendeshea mwenyewe?

Kwa repositories zilizo uchi (bare repositories), git clone --mirror kutoka mashine nyingine hunakili kila ref na object, na git remote update ndani ya mirror hiyo huifanya upya. Kwa Forgejo au Gitea, repositories ni sehemu tu ya hali ya mfumo, kwa sababu issues, pull requests, watumiaji na funguo (keys) hukaa kwenye database. Tumia dump iliyojengewa ndani, sudo -u git forgejo dump -c /etc/forgejo/app.ini, au amri hiyo hiyo ndani ya container kwa usakinishaji wa Docker. Nakili archive hiyo nje ya seva, na uifanyie restore kwenye mashine ya ziada mara moja ili uhakikishe kuwa utaratibu huo unafanya kazi.

Je, makala hii ilikusaidia?

#git#self-hosting#forgejo#gitea#ssh