Forgejo, Gitea czy cgit? Serwer Git self-hosted
Porównanie 4 sposobów uruchomienia serwera Git według zużycia RAM: bare repozytoria przez SSH, cgit, Forgejo lub Gitea oraz GitLab. Sprawdź, co obsłuży VPS 1 GB.
Który self-hosted serwer Git uruchomić
Self-hosted serwer Git nie jest jednym produktem, a pamięć RAM (random access memory) VPS-a decyduje o tym, którą jego wersję można uruchomić. Git nie wymaga własnego demona: repozytorium bare oraz konto SSH (secure shell) już tworzą działający serwer na najmniejszym dostępnym serwerze. Wszystko powyżej tego poziomu jest aplikacją webową uruchamianą obok niego, a każdy kolejny poziom zużywa pamięć, której mały VPS może nie mieć. Jeśli nadal nie jest jasne, gdzie kończy się Git, a zaczyna GitHub, artykuł czym różnią się Git, GitHub i własny serwer Git wyjaśnia ten podział przed wyborem poziomu.
Istnieją cztery poziomy. Repozytorium bare dostępne przez SSH, bez uruchamiania dodatkowego procesu nasłuchującego. cgit, szybki, tylko do odczytu interfejs webowy bez bazy danych. Forgejo lub Gitea, pełna forge z kontami, zgłoszeniami i pull requestami, działająca przy zużyciu kilkuset megabajtów. GitLab, który wymaga serwera wielokrotnie większego niż pozostałe rozwiązania.
Decyzję należy podjąć na podstawie wymaganych prac, a następnie porównać ilość pamięci z parametrami opłacanego planu.
Ile pamięci RAM rzeczywiście wymaga każda opcja
Tylko dwa z tych projektów publikują wymagania sprzętowe. Opublikowaną wartość należy traktować jako minimum, a nie gwarancję. Po uruchomieniu własnej instancji należy zmierzyć jej rzeczywiste zużycie pamięci za pomocą systemd-cgtop lub ps -o rss= -C forgejo.
Dane, na których opiera się ten wykres
[
{
"label": "Gitea, small team",
"ram_gb": 1
},
{
"label": "GitLab, memory constrained",
"ram_gb": 8
},
{
"label": "GitLab, single node baseline",
"ram_gb": 16
}
]Dokumentacja Gitea wskazuje, że 1 GB pamięci RAM i 2 rdzenie CPU zwykle wystarczają małym zespołom i projektom. Wskazuje również Raspberry Pi 3 jako wystarczający sprzęt dla małych obciążeń. Dokumentacja GitLab podaje 16 GB jako minimum dla instalacji jednowęzłowej oraz 8 GB jako dolną granicę dla środowiska z ograniczoną ilością pamięci, zgodnie z określeniem użytym na stronie projektu. Dokumentacja instalacyjna Forgejo nie podaje wymaganej ilości pamięci RAM. Forgejo jest forkiem Gitea i działa w podobny sposób, dlatego wartość podana dla Gitea jest najbliższą dostępną wskazówką.
Na VPS z 1 GB oznacza to, że repozytoria bare i cgit zmieszczą się z zapasem, ponieważ żaden z tych komponentów nie uruchamia stale działającej usługi. Forgejo lub Gitea uruchomi się i będzie obsługiwać mały zespół z bazą SQLite, ale jest to poziom odpowiadający opublikowanemu minimum. Dlatego nie należy uruchamiać PostgreSQL ani runnera CI (continuous integration) na tym samym serwerze. Jeśli interfejs WWW zniknie bez komunikatu o błędzie, należy uruchomić sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' i poszukać wiersza takiego jak Out of memory: Killed process 1181 (forgejo). Oznacza on, że kernelowy mechanizm OOM killer zakończył proces z powodu braku pamięci. GitLab na serwerze z 1 GB nie wymaga dostrajania. Nie będzie działać.
Warstwa 0: zwykłe repozytorium przez SSH
Git nie ma demona sieciowego, którego trzeba uruchamiać. git push przez SSH uruchamia git-receive-pack po stronie zdalnej jako zwykły proces Unix, więc każde konto, z którym można nawiązać połączenie za pomocą klucza, jest już zdalnym repozytorium Git. Należy utworzyć jedno konto dla repozytoriów i przechowywać repozytoria poza jego katalogiem domowym, aby późniejszy widok WWW nie wymagał dostępu do tego katalogu.
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 tworzy repozytorium bez kopii roboczej, czyli takie, jakie jest przechowywane na serwerze. Wysyłanie zmian do wyewidencjonowanej gałęzi repozytorium, które ma kopię roboczą, jest domyślnie odrzucane przez refusing to update checked out branch: refs/heads/main. Jest to najczęstszy błąd na tym poziomie.
Następnie należy nadać kontu klucz i sklonować repozytorium.
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 mainPomyślne pierwsze wysłanie zmian kończy się komunikatem * [new branch] main -> main. Jeśli kończy się komunikatem git@vps.example.com: Permission denied (publickey), uwierzytelnianie nie powiodło się, dlatego należy odczytać dziennik serwera za pomocą sudo journalctl -u ssh -n 20. Wiersz zawierający Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys oznacza nieprawidłowego właściciela lub tryb pliku, ponieważ sshd odrzuca plik klucza, którego właściciel nie jest zaufany lub który można modyfikować innym użytkownikom.
Jeśli element origin projektu wskazuje już na GitHub, git remote add origin kończy działanie z komunikatem error: remote origin already exists.. Dodanie tego serwera jako drugiego adresu wysyłania zmian dla tego zdalnego repozytorium pozwala jednemu poleceniu git push aktualizować oba repozytoria.
Następnie należy odebrać temu kontu dostęp do powłoki.
command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" gitgit-shell akceptuje wyłącznie kilka poleceń wysyłanych przez Git za pośrednictwem SSH, dlatego interaktywne logowanie kończy się teraz komunikatem zamiast wyświetleniem znaku zachęty:
fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.To jest cały serwer. Nie ma bazy danych ani procesu WWW wymagającego aktualizacji. Rezygnuje się jednak ze wszystkich funkcji oferowanych przez forge: przeglądania repozytoriów, systemu zgłoszeń, pull requestów i uprawnień przypisanych poszczególnym użytkownikom. Każdy klucz w tym pliku może odczytywać i zapisywać każde repozytorium należące do użytkownika git.
Warstwa 1: cgit udostępnia widok WWW bez bazy danych
cgit to program CGI (Common Gateway Interface) napisany w języku C. Serwer WWW uruchamia go raz dla każdego żądania. Program odczytuje repozytoria bezpośrednio z dysku i nie przechowuje własnego stanu. Ubuntu 24.04 zawiera go w komponencie universe.
sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgitWskaż katalog repozytoriów w /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 przeszukuje ten katalog i wyświetla wszystkie znalezione repozytoria. Dzięki temu nowe repozytorium bare pojawia się bez dodatkowej konfiguracji. cache-size określa liczbę stron przechowywanych w pamięci podręcznej. Buforowanie pozostaje wyłączone, gdy wartość wynosi zero. Przed dodaniem własnych wierszy sprawdź zawartość /etc/cgitrc dostarczoną przez zainstalowany pakiet, ponieważ pakiet Debian i Ubuntu dodaje własne wartości domyślne.
Każdy wpis wyświetla pierwszy wiersz pliku description repozytorium. Dlatego nowe repozytorium bare wyświetla się jako Unnamed repository; edit this file 'description' to name the repository.. Uzupełnij tę wartość osobno dla każdego repozytorium:
echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/descriptionPlik witryny nginx i sposób jego sprawdzenia
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 udostępnia cgit.css oraz cgit.png jako zwykłe pliki, a try_files przekazuje wszystkie pozostałe żądania do CGI pod adresem /usr/lib/cgit/cgit.cgi. Strona błędu 502, zawierająca connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) w /var/log/nginx/error.log, oznacza, że jednostka socket nie działa albo nasłuchuje pod inną ścieżką. Wiersz systemctl show wyświetla ścieżkę faktycznie używaną przez usługę.
Przed dalszą konfiguracją warto znać dwa ograniczenia. cgit działa tylko do odczytu i w tej konfiguracji nie zapewnia logowania. Wszystko w scan-path jest więc publiczne. Nie umieszczaj prywatnego repozytorium w tym katalogu albo zastosuj uwierzytelnianie HTTP Basic przed całą witryną. CGI działa jako użytkownik serwera WWW. Użytkownik ten musi mieć możliwość przechodzenia przez /srv/git oraz odczytu każdego repozytorium. Katalog, do którego nie może wejść, pojawia się jako pusty indeks zamiast komunikatu błędu.
Poziom 2: Forgejo lub Gitea do obsługi zgłoszeń i pull requestów
Forgejo i Gitea opierają się na tej samej koncepcji: pojedynczy plik binarny Go obsługujący platformę programistyczną z użytkownikami, organizacjami, zgłoszeniami (issues), pull requestami, wydaniami (releases), rejestrem pakietów oraz wbudowanym systemem CI. Cała instalacja składa się z pliku binarnego i bazy SQLite, dzięki czemu oprogramowanie to działa na sprzęcie, na którym GitLab nie mógłby pracować. Poniższy plik Compose pochodzi z dokumentacji Forgejo i zawiera tag obrazu aktualny na dzień 24 października 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 17 odnosi się do linii v17. Forgejo v17.0.1, wydane 26 października 2026, jest aktualnym stabilnym wydaniem, a Forgejo wspiera v17 do 28 stycznia 2027. Starsza linia v16 utraciła wsparcie 29 października 2026, więc istniejące instalacje korzystające z tagu 16 wymagają aktualizacji. Przejście między głównymi wersjami w późniejszym terminie jest procesem ręcznym, dlatego korzystniej jest rozpocząć pracę od aktualnej wersji.
docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1Polecenie curl powinno wyświetlić linię statusu HTTP. Przed zakończeniem konfiguracji wstępnej może to być przekierowanie do /install, co nadal oznacza, że usługa działa. Jeśli kontener kończy działanie, najczęstszą przyczyną jest kwestia uprawnień: katalog ./forgejo musi należeć do UID (identyfikatora użytkownika) określonego w USER_UID, w przeciwnym razie proces nie może zapisać danych we własnym katalogu. Artykuł Docker Compose na VPS szczegółowo omawia strukturę plików oraz zasady dotyczące uprawnień wolumenów.
Dwie odpowiedzi na stronie konfiguracji decydują o tym, czy adresy URL do klonowania będą działać. Port SSH musi odpowiadać stronie hosta w mapowaniu SSH, co w powyższym pliku Compose wynosi 222, ponieważ mapuje port hosta 222 na port 22 kontenera. Sam port 222 nie jest wymagany: zadziała każdy wolny port hosta, o ile mapowanie i ta odpowiedź są ze sobą zgodne. Domena musi być nazwą, którą użytkownicy będą faktycznie wpisywać. Błąd w którymkolwiek z tych ustawień spowoduje, że na każdej stronie repozytorium pojawi się polecenie klonowania, które nie zadziała dla nikogo. Oba ustawienia znajdują się później w sekcji [server] pliku app.ini, jako SSH_PORT, SSH_DOMAIN oraz ROOT_URL.
W przypadku instancji publicznej należy opublikować port WWW wyłącznie na adresie loopback ('127.0.0.1:3000:3000') i umieścić przed nim nginx w celu obsługi TLS (transport layer security). Gitea instaluje się w ten sam sposób z obrazu docker.gitea.com/gitea używanego w jej dokumentacji lub jako pojedynczy plik binarny z jedną jednostką systemd i jednym plikiem app.ini. Aktualne stabilne wydanie to v28.4.0, opublikowane 15 listopada 2026. Wraz z wersją v28.0.0 pod koniec września projekt porzucił stary prefiks 1., więc wydanie po 1.27 to 28, a nie 1.28.
Należy pozostać przy SQLite, dopóki jest to możliwe. Pozwala to utrzymać instancję jako jeden proces i jeden plik, który przetrwa restart bez konieczności nadzorowania dodatkowej usługi. PostgreSQL staje się opłacalny, gdy kilka osób zapisuje dane jednocześnie, ponieważ SQLite szereguje zapisy, a długie procesy CI zapisują dane w sposób ciągły. Oba projekty umożliwiają późniejsze przeniesienie istniejącej instancji do PostgreSQL, więc nie jest to decyzja ostateczna.
Forgejo lub Gitea: co faktycznie różni te projekty
Projekty mają wspólną historię. Gitea powstała jako fork Gogs w 2016 roku. Pod koniec 2022 roku kontrola nad domeną i znakiem towarowym Gitea przeszła na firmę Gitea Ltd, a kilku opiekunów projektu wraz z Codeberg uruchomiło Forgejo. Forgejo jest rozwijane przez społeczność pod egidą Codeberg e.V., organizacji non-profit zarejestrowanej w Niemczech, która zarządza domenami projektu, podczas gdy zarządzanie pozostaje w rękach współtwórców Forgejo. W 2024 roku projekt przeszedł z licencji MIT na GPLv3 (GNU general public license version 3). Gitea pozostaje na licencji MIT i jest rozwijana przy wsparciu komercyjnym.
Na co dzień zestawy funkcji są zbliżone. Ścieżka migracji między nimi nie jest jednak prosta. Forgejo v10.0, wydane w styczniu 2025, było ostatnim wydaniem, które mogło bezpośrednio zaimportować bazę danych Gitea, i to tylko z wersji Gitea v1.22 lub starszej. Gitea jest w wersji v28.4.0 na dzień 16 listopada 2026, więc aktualna instancja Gitea nie posiada wspieranej ścieżki bezpośredniego przejścia na Forgejo. Należy wybrać jedno rozwiązanie przed wypełnieniem go danymi, a każdą późniejszą zmianę traktować jako eksport i ponowny import.
Krótka zasada wyboru: jeśli kwestie zarządzania są istotne lub projekt ma działać pod egidą organizacji non-profit, należy wybrać Forgejo. Jeśli priorytetem jest większa baza instalacyjna i opcja wsparcia komercyjnego, należy wybrać Gitea. Oba projekty są rozwijane otwarcie i często wydawane: Forgejo publikuje stabilne wydanie co trzy miesiące oraz wydanie LTS (long term support) każdego roku, z wersją v17.0.1 jako aktualną i v15.0.11 jako LTS na dzień 29 października 2026. Forgejo wspiera v17 do 28 stycznia 2027, a v15 do 15 lipca 2027, podczas gdy wsparcie dla v16 zakończyło się 29 października 2026, dlatego przed przypięciem głównej wersji należy sprawdzić stronę wydań. Jeśli żadna z tych zasad nie rozstrzyga wyboru, pełne porównanie Forgejo i Gitea wyjaśnia różnice w działaniu Actions i rejestrów pakietów – są to szczegóły, które należy ustalić, zanim ilość danych uczyni zmianę kosztowną.
Warstwa 3: ile GitLab kosztuje, zanim zacznie cokolwiek robić
GitLab CE to inna klasa oprogramowania. Jedna instancja składa się ze współpracujących usług: Puma dla aplikacji internetowej, Sidekiq dla zadań wykonywanych w tle, PostgreSQL, Redis, Gitaly do obsługi repozytoriów oraz nginx z przodu. Pakiet Omnibus instaluje je razem, co upraszcza instalację, ale zwiększa minimalne wymagania dotyczące pamięci.
Strona z wymaganiami GitLab podaje 16 GB RAM i 8 vCPU jako wartości bazowe dla instalacji jednowęzłowej. W środowisku z ograniczoną pamięcią wskazuje 8 GB jako dolną granicę. Na tej samej stronie zalecono wyłączenie swap, ponieważ użycie swap podczas obciążenia znacznie pogarsza działanie instancji. Są to opublikowane wartości na październik 2026. Z biegiem lat wymagania wzrosły, dlatego przed dobraniem serwera należy ponownie sprawdzić tę stronę.
W zamian za te zasoby otrzymuje się konkretne funkcje: rejestr obrazów kontenerów, rejestr pakietów, szczegółowe uprawnienia oraz CI przetestowane na dużą skalę. Centrum zgodności oraz dzienniki audytowe projektów lub grup wymagają płatnego poziomu GitLab. Jeżeli nikt w zespole nie potrafi wskazać funkcji z tej listy, która będzie potrzebna w tym kwartale, oznacza to płacenie za większy VPS bez uzyskania realnych korzyści.
Model dostępu SSH: jeden użytkownik git i wiele kluczy
W systemowym OpenSSH każda warstwa korzysta z tego samego modelu uwierzytelniania. Istnieje jedno konto Unix o nazwie git, a wszystkie klucze publiczne są umieszczane w pliku ~/.ssh/authorized_keys tego konta. Klucz służy do uwierzytelniania. Autoryzację określają opcje zapisane przed kluczem w tym samym wierszu.
Zwykły wiersz z kluczem daje jego posiadaczowi wszystkie uprawnienia dostępne dla tego konta. Jeśli konto nadal używa /bin/bash jako powłoki logowania, wymuszenie polecenia ogranicza dostęp do Git:
restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptoprestrict, dostępne od OpenSSH 7.2, wyłącza przekierowanie portów, przekierowanie agenta, X11 oraz przydzielanie PTY (pseudo terminala) za pomocą jednej opcji. command= zastępuje polecenie żądane przez klienta poleceniem wskazanym w tej opcji, a Git nadal działa, ponieważ serwer SSH umieszcza oryginalne polecenie klienta w $SSH_ORIGINAL_COMMAND.
Platforma zarządza tym plikiem automatycznie. Jest to zasadnicza różnica między warstwą 0 a warstwą 2. Gdy korzystają z systemowego serwera OpenSSH, który jest ich domyślną konfiguracją, Forgejo i Gitea przepisują authorized_keys, umieszczając po jednym wierszu dla każdego zarejestrowanego klucza. Każdy wiersz zawiera wymuszone polecenie identyfikujące klucz za pomocą identyfikatora w bazie danych:
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 aliceWymuszone polecenie umożliwia zastosowanie osobnych uprawnień dla użytkowników korzystających ze wspólnego konta Unix: key-3 informuje platformę, który użytkownik się łączy, a platforma sprawdza tego użytkownika względem repozytorium, zanim nastąpi przesłanie obiektów. Nie należy ręcznie edytować tego pliku na serwerze zarządzanym przez platformę, ponieważ jest on generowany ponownie na podstawie bazy danych, a dodany wiersz zostanie usunięty. Po włączeniu wbudowanego serwera SSH platformy albo skonfigurowaniu OpenSSH do pobierania kluczy z platformy przez AuthorizedKeysCommand plik ten nie jest potrzebny. W drugim przypadku oba projekty zalecają wyłączenie jego generowania. Klucze wdrażania korzystają z tego samego mechanizmu: klucz wdrażania jest zwykłym kluczem SSH zarejestrowanym dla jednego repozytorium, zwykle tylko do odczytu. Sprawdzenie odbywa się w platformie, a nie w sshd.
Dwa nawyki są ważniejsze niż wszystkie opisane wyżej ustawienia. Należy używać jednego klucza na osobę lub maszynę, nigdy wspólnego klucza, ponieważ unieważnienie wspólnego klucza wymaga jego wymiany u wszystkich użytkowników jednocześnie. Klucze należy usuwać w dniu odejścia użytkownika, ponieważ stary klucz w tym pliku zapewnia stały dostęp do logowania, którego nikt nie monitoruje. Dobre zarządzanie kluczami SSH na serwerze omawia typy kluczy i hasła, a wszystkie te zasady mają tutaj zastosowanie bez zmian. Jeśli serwer jest nowy, przed umieszczeniem na nim repozytoriów należy wykonać czynności opisane w sekcji pierwsze dziesięć minut na nowym VPS.
Czy można uruchamiać GitHub Actions na własnym serwerze Git?
Można uruchamiać workflow zapisane w składni GitHub Actions. Nie można uruchamiać GitHub. Forgejo Actions jest domyślnie włączone od wersji Forgejo v1.21 i odczytuje pliki workflow z .forgejo/workflows w każdym repozytorium. Gitea Actions działa tak samo i odczytuje .gitea/workflows. W obu przypadkach potrzebny jest drugi program — runner — zainstalowany i zarejestrowany w danej instancji za pomocą tokena z ustawień administratora. Wiele opublikowanych actions działa bez zmian.
Należy uwzględnić dwie konsekwencje. Przy typowych etykietach kontenera runner uruchamia kontener dla każdego zadania. Dlatego potrzebuje własnego silnika kontenerów i własnego budżetu pamięci. Z tego powodu nie powinien działać na tym samym serwerze z 1 GB pamięci co forge. Oba runnery mogą również uruchamiać zadania bezpośrednio na hoście za pomocą etykiety kończącej się ciągiem :host w Forgejo. Nie wymaga to silnika kontenerów, ale nie zapewnia też izolacji kontenera między zadaniem a tym komputerem. Runner wykonuje wszystko, co określa plik workflow. Dokumentacja Forgejo stwierdza to wprost: runner wykonuje zdalne wykonanie kodu. Jeśli jest to możliwe, należy przydzielić mu osobny host. Co najmniej należy użyć osobnego użytkownika bez uprawnień uprzywilejowanych oraz tokena rejestracyjnego ograniczonego do jednego repozytorium.
Jeśli repozytoria pozostają w GitHub, a potrzebne jest tylko uruchamianie zadań na sprzęcie znajdującym się pod własną kontrolą, jest to inna konfiguracja i wymaga innych kroków: self-hosted runner GitHub Actions łączy się z repozytorium GitHub i nie wymaga żadnego z powyższych elementów. Jeśli nadal analizowane są koszty rezygnacji, co właściwie zapewnia GitHub rozdziela hosting Git od otaczającej go infrastruktury sieciowej.
Kopie zapasowe: repozytoria obejmują tylko część stanu
Repozytorium typu bare jest katalogiem, więc jego skopiowanie kopiuje całą zawartość. Klon lustrzany z innego komputera jest rzeczywistą kopią zapasową i aktualizuje się w miejscu:
git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote updatePobierane są wszystkie odwołania i wszystkie obiekty. Nie są pobierane hooki po stronie serwera ani plik description, dlatego w przypadku używania hooków należy zachować również kopię katalogu na poziomie plików.
Forge przechowuje zgłoszenia, pull requesty, użytkowników, klucze i uprawnienia w bazie danych, a sama kopia repozytoriów usuwa wszystkie te dane. Oba projekty udostępniają polecenie dump, które zapisuje bazę danych, repozytoria, konfigurację i załączniki w jednym archiwum:
sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zipW Dockerze to samo polecenie jest uruchamiane wewnątrz kontenera, a ścieżka konfiguracji zależy od obrazu, dlatego przed wpisaniem polecenia należy ją sprawdzić:
docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.iniPolecenie należy uruchamiać jako użytkownik będący właścicielem danych, a archiwum zapisywać w katalogu, do którego ten użytkownik ma prawo zapisu. Następnie należy skopiować archiwum poza serwer, ponieważ kopia zapasowa istniejąca wyłącznie na zabezpieczanej maszynie nie jest kopią zapasową. Przywracanie to etap, który jest często pomijany: należy już teraz rozpakować jeden zrzut na zapasowej maszynie, aby poznać procedurę w spokojnych warunkach, a nie dopiero podczas awarii.
Wybór w zależności od scenariusza
Jedna osoba z laptopem i VPS-em, bez potrzeby przeglądania kodu: repozytoria typu bare przez SSH. Nie działa żadna dodatkowa usługa i nie ma niczego do aktualizowania.
To samo, ale z potrzebą przeglądania kodu w przeglądarce i udostępniania do niego linków: należy dodać cgit. Nadal nie jest potrzebna baza danych ani żadna stale działająca usługa.
Zespół, który wzajemnie przegląda kod i śledzi zgłoszenia: Forgejo lub Gitea, na serwerze z co najmniej 2 GB RAM. Po rozpoczęciu uruchamiania rzeczywistych zadań CI należy przenieść runnera CI na drugi serwer.
Organizacja, która potrzebuje rejestru kontenerów i śladów audytowych oraz może przeznaczyć 16 GB RAM na serwer: GitLab. Przy mniejszym budżecie nie należy go uruchamiać.
Przejście przez trzy pierwsze poziomy jest tanie, ponieważ we wszystkich repozytoria są zwykłymi katalogami Git na dysku. Należy rozpocząć od najniższego poziomu, który spełnia wymagania. Jeśli ustalane jest, jakie inne usługi powinny działać na tym samym serwerze, krótka lista usług, które warto hostować samodzielnie umieszcza serwer Git obok pozostałych usług konkurujących o tę pamięć RAM.
FAQ
Czy VPS z 1 GB może uruchomić Forgejo lub Gitea?
Tak, w przypadku małego zespołu, przy użyciu SQLite i bez innych wymagających zasobów usług na serwerze. Dokumentacja Gitea podaje 1 GB RAM i 2 rdzenie CPU jako wartości zwykle wystarczające dla małych zespołów i projektów. Forgejo jest forkiem Gitea o podobnych wymaganiach. Nie należy dodawać PostgreSQL ani CI runnera na tym samym serwerze. Jeśli usługa znika bez błędu we własnym dzienniku, należy uruchomić sudo dmesg -T | grep -Ei 'oom|out of memory|killed process'. Wiersz zawierający nazwę zakończonego procesu oznacza, że zadziałał kernelowy OOM killer. W takiej sytuacji należy zwiększyć plan, a nie zmieniać flagę strojenia.
Jaka jest różnica między Forgejo a Gitea?
Projekty mają wspólną historię kodu i większość funkcji. Gitea została sforkowana z Gogs w 2016, a Forgejo została sforkowana z Gitea pod koniec 2022, po przeniesieniu kontroli nad znakiem towarowym Gitea do firmy. Forgejo jest rozwijane przez społeczność pod auspicjami Codeberg e.V., organizacji non-profit w Niemczech, i wydawane na licencji GPLv3. Gitea pozostaje dostępna na licencji MIT i jest wspierana komercyjnie. Praktyczna różnica dotyczy ścieżki migracji. Forgejo v10.0 ze stycznia 2025 było ostatnim wydaniem, które mogło bezpośrednio użyć bazy danych Gitea, wyłącznie z Gitea v1.22 lub starszej. Obecnej instancji Gitea nie można więc przełączyć w miejscu w sposób oficjalnie obsługiwany.
Czy można uruchamiać workflow GitHub Actions na samodzielnie hostowanym serwerze Git?
Forgejo Actions i Gitea Actions uruchamiają workflow zapisane w składni YAML GitHub Actions, odczytywane z .forgejo/workflows i .gitea/workflows. Należy zainstalować osobny program runnera i zarejestrować go w instancji. Wiele opublikowanych actions działa bez zmian. Runner wykonuje dowolny kod z repozytoriów i przy użyciu standardowych etykiet kontenerów uruchamia osobny kontener dla każdego zadania. Należy więc przydzielić mu osobny serwer albo przynajmniej osobnego użytkownika bez uprawnień uprzywilejowanych. Nie należy uruchamiać go na serwerze z 1 GB, na którym działa już forge.
Jak wykonać kopię zapasową samodzielnie hostowanego serwera Git?
W przypadku repozytoriów bare polecenie git clone --mirror uruchomione na innym komputerze kopiuje wszystkie refy i obiekty, a git remote update wykonane w tym mirrorze odświeża jego zawartość. W Forgejo lub Gitea repozytoria stanowią tylko część danych, ponieważ issues, pull requests, użytkownicy i klucze są przechowywane w bazie danych. Należy użyć wbudowanego polecenia dump, sudo -u git forgejo dump -c /etc/forgejo/app.ini, albo tego samego polecenia wewnątrz kontenera w instalacji Docker. Archiwum należy skopiować poza serwer i jednorazowo odtworzyć je na zapasowej maszynie, aby potwierdzić poprawność procedury.