SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

Self-hosted Git sunucusu: Forgejo mu, Gitea mı, cgit mi?

RAM kullanımına göre dört self-hosted Git sunucusunu karşılaştırın: SSH üzerinden bare repository, cgit, Forgejo veya Gitea ve GitLab. 1 GB VPS ne çalıştırabilir?

Hangi self-hosted Git sunucusunu çalıştırmalısınız

Self-hosted Git sunucusu tek bir üründen ibaret değildir ve VPS üzerindeki RAM (random access memory), hangi sürümünü çalıştırabileceğinizi belirler. Git'in kendi daemon'ına ihtiyacı yoktur: çıplak bir repository ile SSH (secure shell) hesabı, kiralayabileceğiniz en küçük sunucuda bile çalışan bir sunucu oluşturur. Bunun üzerindeki her seçenek, bu yapının yanında çalıştırmayı seçtiğiniz bir web uygulamasıdır ve her üst seviye, küçük bir VPS'de bulunmayabilecek ek bellek tüketir. Git'in nerede bitip GitHub'ın nerede başladığından hâlâ emin değilseniz, bir katman seçmeden önce Git, GitHub ve kendi Git sunucunuz arasındaki farklar bu ayrımı açıklar.

Dört seçenek vardır. SSH üzerinden çalışan çıplak bir repository; zaten dinlemekte olanlar dışında hiçbir servis dinlemez. cgit, veritabanı gerektirmeyen, hızlı ve salt okunur bir web görünümüdür. Forgejo veya Gitea, birkaç yüz megabayt bellekle hesaplar, issue'lar ve pull request'ler sunan tam özellikli Git platformlarıdır. GitLab ise diğerlerinin birçok katı büyüklüğünde bir sunucu bekler.

İhtiyacınız olan çalışmaya göre karar verin, ardından bellek değerini ödeme yaptığınız planla karşılaştırın.

Her seçeneğin gerçekten ihtiyaç duyduğu RAM miktarı

Bu projelerden yalnızca ikisi donanım gereksinimi yayımlar. Yayımlanan değeri kesin bir vaat değil, alt sınır olarak değerlendirin. Kendi instance'ınız çalışmaya başladıktan sonra systemd-cgtop veya ps -o rss= -C forgejo ile ölçüm yapın.

GrafikRAM the projects document, official docs, October 2026
Bu grafiğin arkasındaki veriler
[
  {
    "label": "Gitea, small team",
    "ram_gb": 1
  },
  {
    "label": "GitLab, memory constrained",
    "ram_gb": 8
  },
  {
    "label": "GitLab, single node baseline",
    "ram_gb": 16
  }
]

Gitea, küçük ekipler ve projeler için 2 CPU çekirdeğiyle 1 GB RAM'in genellikle yeterli olduğunu belirtir. Ayrıca küçük iş yükleri için Raspberry Pi 3'ün yeterli olduğunu ifade eder. GitLab, tek düğümlü kurulum için 16 GB RAM'i temel gereksinim olarak belgeler. Kendi sayfasında bellek kısıtlı ortam olarak tanımladığı yapı için alt sınırı 8 GB olarak verir. Forgejo'nun kurulum belgelerinde RAM gereksinimi belirtilmez. Forgejo, Gitea'nın bir fork'udur ve benzer şekilde çalışır. Bu nedenle elinizdeki en yakın yayımlanmış kılavuz değeri Gitea'nın değeridir.

Bunun 1 GB VPS üzerindeki karşılığı şöyledir: Bare repository'ler ve cgit, geride yeterli kaynak kalacak şekilde çalışır. Bunun nedeni, ikisinin de sürekli çalışan bir servis başlatmamasıdır. Forgejo veya Gitea başlar ve SQLite üzerinde küçük bir ekibe hizmet verebilir. Ancak belgelenen alt sınırda çalıştığınız için PostgreSQL'i ve CI (continuous integration) runner'ını bu sunucuda çalıştırmayın. Web arayüzü hata göstermeden kaybolursa sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' komutunu çalıştırın ve Out of memory: Killed process 1181 (forgejo) benzeri bir satır arayın. Bu satır, kernel'in out of memory killer'ının süreci sonlandırdığını gösterir. GitLab'ın 1 GB bir sunucuda çalışmaması bir ayar sorunu değildir. Çalışmaz.

Tier 0: SSH üzerinden bare repository

Git için başlatılması gereken bir ağ daemon'u yoktur. git push, SSH üzerinden uzak uçta git-receive-pack komutunu normal bir Unix süreci olarak çalıştırır. Bu nedenle anahtar ile erişilebilen her hesap zaten bir Git remote'udur. Repository'ler için ayrı bir hesap oluşturulmalı ve repository'ler bu hesabın home directory'si dışında tutulmalıdır. Böylece daha sonra eklenecek bir web görünümü için bu home directory'sine erişim verilmesi gerekmez.

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 içermeyen bir repository oluşturur. Sunucuda tutulması gereken yapı budur. Working copy içeren bir repository'nin checkout edilmiş branch'ine push yapılması, varsayılan olarak refusing to update checked out branch: refs/heads/main nedeniyle reddedilir. Bu katmandaki en yaygın hata budur.

Şimdi hesaba bir key verin ve repository'yi clone edin.

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

Başarılı ilk push işlemi * [new branch] main -> main ile tamamlanır. git@vps.example.com: Permission denied (publickey) ile tamamlanan işlemde kimlik doğrulaması hiç yapılmamıştır; bu nedenle sunucu log'unu sudo journalctl -u ssh -n 20 ile okuyun. Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys satırı, ownership veya file mode ayarının hatalı olduğu anlamına gelir. sshd, güvenilmeyen bir owner'a ait olan veya diğer kullanıcıların yazabildiği bir key file'ını reddeder.

Projenin origin değeri zaten GitHub'ı gösteriyorsa git remote add origin işlemi error: remote origin already exists. ile durur. bu sunucuyu ilgili remote'a ikinci bir push URL olarak eklemek, tek bir git push komutuyla her ikisinin de güncellenmesini sağlar.

Ardından hesabın shell erişimini kaldırın.

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

git-shell yalnızca Git'in SSH üzerinden gönderdiği birkaç komutu kabul eder. Bu nedenle etkileşimli login artık bir prompt yerine bir mesajla sonlanır:

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

Sunucunun tamamı bundan ibarettir. Veritabanı yoktur ve yükseltilmesi gereken bir web süreci yoktur. Bunun karşılığında bir forge'un sunduğu tüm özelliklerden vazgeçilir: tarama, issue tracker, pull request ve kullanıcı bazında yetkilendirme yoktur. Bu dosyadaki her key, git kullanıcısının sahip olduğu her repository'yi okuyabilir ve yazabilir.

Tier 1: cgit, veritabanı olmadan web görünümü sunar

cgit, C ile yazılmış bir CGI (common gateway interface) programıdır. Web sunucusu programı her istek başına bir kez çalıştırır, depoları doğrudan diskten okur ve kendi durumunu saklamaz. Ubuntu 24.04, cgit'i universe bileşeninde sunar.

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

/etc/cgitrc içindeki depo dizinini belirtin:

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 bu dizini tarar ve bulduğu tüm depoları listeler. Böylece yeni bir bare depo ek yapılandırma gerektirmeden görünür. cache-size önbelleğe alınan sayfa sayısıdır. Bu değer sıfır olduğunda önbelleğe alma devre dışıdır. Satır eklemeden önce paketinizin /etc/cgitrc dosyasına yazdığı mevcut içeriği okuyun. Debian ve Ubuntu paketleri kendi varsayılan ayarlarının bir bölümünü ekler.

Her girişte, deponun description dosyasındaki ilk satır gösterilir. Bu nedenle yeni bir bare depo kendisini Unnamed repository; edit this file 'description' to name the repository. olarak listeler. Bunu her depo için bir kez düzeltin:

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
nginx site dosyası ve nasıl denetleneceği
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, cgit.css ve cgit.png dosyalarını düz metin olarak sunar. try_files ise diğer tüm istekleri /usr/lib/cgit/cgit.cgi konumundaki CGI programına iletir. /var/log/nginx/error.log içinde connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) bulunan bir 502 sayfası, socket unit'in çalışmadığı veya başka bir path üzerinde dinlediği anlamına gelir. systemctl show satırı, programın gerçekte kullandığı path'i yazdırır.

Üzerine yapı kurmadan önce bilinmesi gereken iki sınır vardır. cgit salt okunurdur ve bu yapılandırmada oturum açma özelliği yoktur. Bu nedenle scan-path altındaki her şey herkese açıktır. Özel bir depoyu bu dizinin dışında tutun veya tüm sitenin önüne HTTP basic authentication ekleyin. Ayrıca CGI, web sunucusu kullanıcısı olarak çalışır. Bu nedenle bu kullanıcının /srv/git içinden geçebilmesi ve her depoyu okuyabilmesi gerekir. Kullanıcının giremediği bir dizin, hata yerine boş bir dizin olarak görünür.

Tier 2: Sorun takibi ve pull request işlemleri için Forgejo veya Gitea

Forgejo ve Gitea aynı mantığa dayanır: kullanıcılar, organizasyonlar, sorun takibi, pull request, sürümler, paket kayıt defteri ve yerleşik CI sistemi içeren bir web geliştirme platformunu tek bir Go binary dosyası ile sunarlar. Binary dosyası ve SQLite kurulumun tamamını oluşturur; bu sayede GitLab'in çalışamayacağı donanımlarda bile sorunsuz çalışırlar. Aşağıdaki Compose dosyası, Forgejo dokümantasyonunda yer alan ve 24 Ekim 2026 itibarıyla belirtilen image etiketini kullanan dosyadır.

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'

Bu 17 etiketi v17 serisini takip eder. 26 Ekim 2026 tarihinde yayınlanan Forgejo v17.0.1 güncel kararlı sürümdür ve Forgejo, v17 sürümüne 28 Ocak 2027 tarihine kadar destek verecektir. Daha eski olan v16 serisinin desteği 29 Ekim 2026 itibarıyla sona ermiştir; bu nedenle 16 etiketinde kalan mevcut kurulumların yükseltilmesi gerekmektedir. Bir ana sürümden diğerine geçiş manuel bir yükseltme gerektirdiğinden, güncel sürümle başlamak daha az maliyetlidir.

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

curl satırı bir HTTP durum satırı yazdırmalıdır. İlk kurulumu tamamlamadan önce bu, servisin çalıştığını gösteren /install adresine bir yönlendirme olabilir. Eğer bunun yerine container kapanıyorsa, yaygın neden sahiplik sorunudur: ./forgejo dizini, USER_UID içindeki UID (kullanıcı kimliği) değerine ait olmalıdır; aksi takdirde süreç kendi veri dizinine yazamaz. Docker Compose on a VPS bölümü, dosya yapısını ve volume sahiplik kuralını tüm detaylarıyla açıklar.

Kurulum sayfasındaki iki yanıt, clone URL'lerinin çalışıp çalışmayacağını belirler. SSH portu, SSH eşleştirmesinin ana makine tarafı olmalıdır; yukarıdaki Compose dosyasında bu 222 değeridir, çünkü ana makine 222 portunu container'ın 22 numaralı portuna eşler. 222 portunun kendisi bir zorunluluk değildir: eşleştirme ve bu yanıt birbiriyle uyumlu olduğu sürece boş olan herhangi bir ana makine portu kullanılabilir. Ayrıca alan adı, insanların gerçekten yazacağı isim olmalıdır. Bunlardan birini yanlış girerseniz, her depo sayfası kopyalayan herkes için başarısız olan bir clone komutu sunar. Her iki ayar da daha sonra app.ini dosyasının [server] bölümünde SSH_PORT, SSH_DOMAIN ve ROOT_URL olarak yer alır.

Halka açık bir instance için, web portunu yalnızca loopback adresi üzerinden yayınlayın ('127.0.0.1:3000:3000') ve TLS (transport layer security) için önüne nginx yerleştirin. Gitea, dokümantasyonunda kullanılan docker.gitea.com/gitea image'ı ile veya tek bir systemd birimi ve bir app.ini dosyası ile tek bir binary olarak aynı şekilde kurulur. Güncel kararlı sürümü 15 Kasım 2026 tarihinde yayınlanan v28.4.0'dır. Eylül ayı sonunda v28.0.0 ile proje eski 1. önekini bırakmıştır; bu nedenle 1.27'den sonraki sürüm 1.28 değil, 28'dir.

Mümkün olduğu sürece SQLite kullanmaya devam edin. Instance'ı tek bir süreç ve tek bir dosya olarak tutar ve ek bir servis denetimine gerek kalmadan yeniden başlatmalardan sonra çalışmaya devam eder. PostgreSQL, birden fazla kişi aynı anda yazma işlemi yaptığında maliyetini karşılar; çünkü SQLite yazma işlemlerini sıraya alır ve uzun süreli CI süreçleri sürekli yazma yapar. Her iki proje de mevcut bir instance'ı daha sonra PostgreSQL'e taşıyabilir, bu yüzden bu geri dönüşü olmayan bir karar değildir.

Forgejo veya Gitea: gerçek farklar nelerdir

Kökenleri ortaktır. Gitea, 2016 yılında Gogs'tan çatallanmıştır (fork). 2022'nin sonlarında Gitea alan adı ve ticari marka kontrolü Gitea Ltd adlı bir şirkete geçmiş, bunun üzerine bazı geliştiriciler Codeberg ile birlikte Forgejo'yu başlatmıştır. Forgejo, projenin alan adlarını elinde tutan ve Almanya'da kayıtlı, kâr amacı gütmeyen bir dernek olan Codeberg e.V. çatısı altında topluluk tarafından geliştirilmektedir; yönetim ise Forgejo'nun kendi katkıcılarında kalmaktadır. 2024 yılında MIT lisansından GPLv3 (GNU general public license version 3) lisansına geçilmiştir. Gitea, MIT lisanslı kalmaya devam etmekte ve ticari destekle geliştirilmektedir.

Günlük kullanımda özellik setleri birbirine yakındır. Ancak aralarındaki geçiş yolu aynı değildir. Ocak 2025 tarihli Forgejo v10.0, doğrudan Gitea veritabanını alabilen son sürümdü ve bu da yalnızca Gitea v1.22 veya daha eski sürümler için geçerliydi. 16 Kasım 2026 itibarıyla Gitea v28.4.0 sürümündedir, dolayısıyla güncel bir Gitea instance'ından Forgejo'ya desteklenen bir geçiş yolu bulunmamaktadır. Veriyle doldurmadan önce birini seçin ve sonraki geçişleri bir dışa aktarma ve yeniden içe aktarma işlemi olarak değerlendirin.

Seçim için kısa bir kural: Eğer yönetim biçimi sizin için önemliyse veya kâr amacı gütmeyen bir çatı altındaki bir projeyi tercih ediyorsanız, Forgejo kullanın. Daha geniş bir kurulum tabanı ve ticari destek seçeneği istiyorsanız, Gitea kullanın. Her ikisi de açık kaynaklı olarak sürdürülmekte ve sık sık yayınlanmaktadır: Forgejo her üç ayda bir kararlı sürüm ve her yıl bir LTS (long term support) sürümü yayınlar; 29 Ekim 2026 itibarıyla v17.0.1 güncel, v15.0.11 ise LTS sürümüdür. Forgejo, v17 sürümüne 28 Ocak 2027'ye, v15 sürümüne ise 15 Temmuz 2027'ye kadar destek verirken, v16 desteği 29 Ekim 2026'da sona ermiştir; bu nedenle bir ana sürümü sabitlemeden önce sürümler sayfasına göz atın. Eğer bu kurallar karara varmanızı sağlamıyorsa, the full comparison of Forgejo and Gitea belgesi, Actions ve paket kayıt defterlerinin nasıl farklılaştığını ortaya koyar; verileriniz geçişi maliyetli hale getirmeden önce bu detayları incelemelisiniz.

Tier 3: GitLab herhangi bir işlem yapmadan önceki maliyeti

GitLab CE farklı bir yazılım sınıfındadır. Tek bir örnek, birlikte çalışan servislerden oluşur: web uygulaması için Puma, arka plan görevleri için Sidekiq, PostgreSQL, Redis, depo erişimi için Gitaly ve önde nginx. Omnibus paketi bu servisleri birlikte kurar. Bu durum kurulumu kolaylaştırır, ancak gerekli minimum bellek miktarını yükseltir.

GitLab'ın gereksinimler sayfasında, tek düğümlü kurulum için temel değer olarak 16 GB RAM ve 8 vCPU belirtilir. Belleğin kısıtlı olduğu ortamlarda alt sınır olarak 8 GB da belirtilir. Aynı sayfada swap özelliğinin devre dışı bırakılması önerilir. Çünkü yük altında swap kullanımı örneğin performansını ciddi biçimde düşürür. Bunlar Ekim 2026 itibarıyla yayımlanan değerlerdir. Gereksinimler yıllar içinde arttı. Bu nedenle sunucu kaynaklarını belirlemeden önce sayfayı yeniden inceleyin.

Bu kaynak bütçesi karşılığında somut özellikler elde edilir: container registry, package registry, ayrıntılı izinler ve geniş ölçekte test edilmiş CI. Compliance center ile proje veya grup audit trail özellikleri için ücretli bir GitLab katmanı gerekir. Ekibinizden hiç kimse bu listeden bu çeyrekte ihtiyaç duyduğu bir özelliği belirtemiyorsa, hiçbir karşılık almadan daha büyük bir VPS için ödeme yapıyorsunuz.

SSH erişim modeli: tek bir git kullanıcısı ve çok sayıda anahtar

Sistem OpenSSH kullanıldığında burada her katmanın kimlik doğrulaması aynı şekilde yapılır. git adlı tek bir Unix hesabı vardır ve tüm public key değerleri bu hesabın ~/.ssh/authorized_keys dosyasına eklenir. Kimlik doğrulama anahtar üzerinden yapılır. Yetkilendirme ise aynı satırda anahtarın önüne yazılan seçeneklerle belirlenir.

Sade bir anahtar satırı, anahtara sahip kişiye bu hesabın yapabildiği her şeyi yapma yetkisi verir. Oturum açma kabuğu olarak hâlâ /bin/bash kullanan bir hesapta forced command, yetkiyi Git ile sınırlar:

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

OpenSSH 7.2 sürümünden beri kullanılabilen restrict, port forwarding, agent forwarding, X11 ve PTY (pseudo terminal) tahsisini tek bir seçenekle devre dışı bırakır. command=, istemcinin talep ettiği komutun yerine belirttiğiniz komutu çalıştırır. Git yine çalışır, çünkü SSH sunucusu istemcinin özgün komutunu $SSH_ORIGINAL_COMMAND içine yerleştirir.

Bir forge bu dosyayı sizin için oluşturur. Tier 0 ile tier 2 arasındaki gerçek fark budur. Varsayılan yapılandırmaları olan sistem OpenSSH sunucusunun arkasında çalıştıklarında Forgejo ve Gitea, authorized_keys dosyasını kaydedilen her anahtar için bir satır olacak şekilde yeniden yazar. Her satırda, anahtarı veritabanı kimliğiyle belirten bir forced command bulunur:

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

Bu forced command, tek bir paylaşılan Unix hesabını kullanıcı bazında yetkilendirmeye dönüştürür: key-3, forge'a hangi kullanıcının bağlandığını bildirir. Forge, herhangi bir nesne aktarılmadan önce bu kullanıcıyı repository ile karşılaştırarak denetler. Forge tarafından yönetilen bir sistemde bu dosyayı elle düzenlemeyin. Dosya veritabanından yeniden oluşturulur ve eklediğiniz satır kaybolur. Forge'un yerleşik SSH sunucusunu etkinleştirirseniz veya OpenSSH'nin anahtarları AuthorizedKeysCommand üzerinden forge'dan istemesini sağlarsanız forge bu dosyaya hiç ihtiyaç duymaz. İkinci durumda her iki proje de dosyanın oluşturulmasını devre dışı bırakmanızı belirtir. Deploy key değerleri de aynı mekanizmadan gelir: deploy key, tek bir repository ile ilişkilendirilmiş sıradan bir SSH anahtarıdır ve genellikle yalnızca okuma yetkisine sahiptir. Denetim sshd yerine forge tarafından yapılır.

Yukarıdaki yapılandırmaların tümünden daha önemli iki alışkanlık vardır. Kişi veya makine başına bir anahtar kullanın; hiçbir zaman paylaşılan anahtar kullanmayın. Çünkü paylaşılan bir anahtarı iptal etmek, anahtarı herkes için aynı anda değiştirmeyi gerektirir. Ayrıca biri sistemden ayrıldığı gün anahtarlarını kaldırın. Bu dosyada kalan eski bir anahtar, kimsenin izlemediği kalıcı bir oturum açma olanağıdır. Sunucuda iyi SSH anahtarı yönetimi, anahtar türlerini ve passphrase kullanımını açıklar; burada da bunların tamamı değişmeden geçerlidir. Sistem yeniyse repository'leri yerleştirmeden önce yeni bir VPS üzerinde ilk on dakika bölümündeki işlemleri uygulayın.

Kendi Git sunucumda GitHub Actions çalıştırabilir miyim?

GitHub Actions sözdizimiyle yazılmış workflow'ları çalıştırabilirsiniz. Ancak GitHub'ın kendisini çalıştıramazsınız. Forgejo Actions, Forgejo v1.21 sürümünden beri varsayılan olarak etkindir ve her repository içindeki .forgejo/workflows konumundaki workflow dosyalarını okur. Gitea Actions da aynı şekilde çalışır ve .gitea/workflows konumunu okur. Her ikisi için de ikinci bir program olan runner'ın yüklenmesi ve yönetici ayarlarındaki bir token kullanılarak instance'a kaydedilmesi gerekir. Yayımlanmış birçok action değişiklik yapılmadan çalışır.

İki sonucu hesaba katın. Standart container etiketleriyle runner her job için bir container başlatır. Bu nedenle kendi container engine'ine ve bellek bütçesine ihtiyaç duyar. Bu yüzden forge ile aynı 1 GB sunucuda çalıştırılmamalıdır. Her iki runner da job'ları doğrudan host üzerinde çalıştırabilir. Forgejo'da bunun için :host ile biten bir label kullanılır. Bu yöntemde container engine gerekmez, ancak job ile makine arasında herhangi bir container katmanı da bulunmaz. Runner ayrıca workflow dosyasında belirtilen her şeyi çalıştırır. Forgejo belgelerinde bu durum açıkça belirtilir: runner uzaktan kod çalıştırma işlemini gerçekleştirir. Mümkünse runner için ayrı bir host kullanın. En azından ayrı bir yetkisiz kullanıcı ve tek bir repository ile sınırlı bir registration token kullanın.

Repository'leriniz GitHub'da kalacaksa ve yalnızca hesaplama işlemlerini kontrol ettiğiniz donanımda çalıştırmak istiyorsanız bu farklı bir kurulumdur ve farklı adımlar gerektirir: self-hosted GitHub Actions runner, bir GitHub repository'sine bağlanır ve bunların hiçbirine ihtiyaç duymaz. Ayrılmanın size maliyetini hâlâ değerlendiriyorsanız GitHub'ın gerçekte neler sunduğu, Git hosting hizmetini bunun çevresindeki ağdan ayırır.

Yedekler: repository'ler durumun yalnızca yarısıdır

Bare repository bir dizindir; bu nedenle kopyalandığında içindeki her şey kopyalanır. Başka bir makineden alınan mirror clone gerçek bir yedektir ve yerinde yenilenir:

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

Bu işlem her ref'i ve her object'i alır. Sunucu tarafındaki hook'ları veya description dosyasını almaz. Bu nedenle hook kullanıyorsanız dizinin dosya düzeyinde bir kopyasını da saklayın.

Bir forge, issue'ları, pull request'leri, kullanıcıları, key'leri ve izinleri veritabanında tutar. Yalnızca repository'lerin kopyalanması bunların tamamını kaybettirir. Her iki proje de veritabanını, repository'leri, yapılandırmayı ve ekleri tek bir arşive yazan bir dump komutu sunar:

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

Docker altında aynı komut container içinde çalıştırılır. Yapılandırma yolu image'a bağlıdır. Bu nedenle komutu yazmadan önce yolu kontrol edin:

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

Komutu verilerin sahibi olan kullanıcıyla çalıştırın ve arşivi bu kullanıcının yazabileceği bir dizine yazın. Ardından arşivi sunucunun dışına kopyalayın. Çünkü yalnızca yedeklenen makinede bulunan bir yedek, yedek değildir. Geri yükleme, atlanan adımdır: Bir dump'ı şimdi yedek bir makineye açın. Böylece işlemi bir kesinti sırasında değil, sakin bir zamanda öğrenirsiniz.

Senaryoya göre seçim

Dizüstü bilgisayarı ve VPS'i olan, tarama gerektirmeyen tek kişi: SSH üzerinden bare repository kullanın. Ek bir servis çalışmaz ve yükseltilecek bir bileşen olmaz.

Aynı durum geçerli, ancak kodu tarayıcıda okumak ve kod bağlantıları göndermek istiyorsanız: cgit ekleyin. Yine veritabanı gerekmez ve sürekli çalışan ek bir bileşen olmaz.

Birbirlerinin kodunu inceleyen ve sorunları takip eden ekip: 2 GB RAM veya daha fazlası olan bir sunucuda Forgejo ya da Gitea kullanın. İşler gerçek bir yük oluşturmaya başladığında CI runner'ı ikinci bir sunucuya taşıyın.

Container registry ve denetim kayıtlarına ihtiyaç duyan, sunucu için 16 GB ayırabilen kuruluş: GitLab kullanın. Bu bütçenin altında GitLab'ı kurmayın.

İlk üç katman arasında yükseltme yapmak ucuzdur, çünkü bu katmanların tümünde repository'ler diskteki sıradan Git dizinleridir. İşi karşılayan en düşük katmanla başlayın. Aynı sunucuda başka hangi hizmetlere yer ayırmanız gerektiğini değerlendiriyorsanız, self-host etmeye değer seçeneklerin kısa listesi Git sunucusunu aynı RAM için yarışan diğer hizmetlerin yanına yerleştirir.

FAQ

1 GB VPS Forgejo veya Gitea çalıştırabilir mi?

Evet. Küçük bir ekip için SQLite kullanıldığında ve sunucuda başka ağır bir iş yükü bulunmadığında çalıştırılabilir. Gitea belgelerinde, küçük ekipler ve projeler için 1 GB RAM ile 2 CPU çekirdeğinin genellikle yeterli olduğu belirtilir. Forgejo da aynı temele sahip bir Gitea fork'udur. Bu makineye PostgreSQL veya CI runner eklenmemelidir. Servis kendi logunda hata görünmeden ortadan kayboluyorsa sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' çalıştırılmalıdır. Öldürülen sürecin adını içeren bir satır, kernel out of memory killer'ın süreci sonlandırdığını gösterir. Bu durumda çözüm bir tuning flag'i değil, daha büyük bir plandır.

Forgejo ile Gitea arasındaki fark nedir?

Kod tabanı geçmişini ve özelliklerin çoğunu paylaşırlar. Gitea, 2016 yılında Gogs'tan fork edilmiştir. Forgejo ise Gitea trademark'ının kontrolü bir şirkete geçtikten sonra, 2022 yılının sonlarında Gitea'dan fork edilmiştir. Forgejo, Almanya'da faaliyet gösteren kar amacı gütmeyen Codeberg e.V. çatısı altında topluluğu tarafından geliştirilir ve GPLv3 kapsamında yayımlanır. Gitea ise ticari destekle MIT lisansını kullanmaya devam eder. Pratik fark, migration path'idir. Ocak 2025 tarihli Forgejo v10.0, Gitea veritabanını doğrudan alabilen son release olmuştur ve bu işlem yalnızca Gitea v1.22 veya daha eski sürümlerden yapılabilmiştir. Bu nedenle güncel bir Gitea instance'ı için desteklenen bir in-place geçiş bulunmaz.

GitHub Actions workflow'larını self-hosted bir Git sunucusunda çalıştırabilir miyim?

Forgejo Actions ve Gitea Actions, GitHub Actions YAML syntax'ı ile yazılmış ve .forgejo/workflows ile .gitea/workflows konumlarından okunan workflow'ları çalıştırır. Ayrı bir runner programı kurulmalı ve instance'a kaydedilmelidir. Yayımlanmış birçok action değişiklik yapılmadan çalışır. Runner, repository'lerinizdeki rastgele kodu çalıştırır ve standart container label'larıyla her job için bir container başlatır. Bu nedenle runner'a ayrı bir host tahsis edilmeli veya en azından ayrı bir unprivileged user kullanılmalıdır. Zaten forge çalıştıran 1 GB'lık bir sunucuda runner çalıştırılmamalıdır.

Self-hosted bir Git sunucusunu nasıl yedeklerim?

Bare repository'ler için başka bir makineden çalıştırılan git clone --mirror, her ref'i ve object'i kopyalar. Bu mirror içindeki git remote update komutu mirror'ı günceller. Forgejo veya Gitea için repository'ler state'in yalnızca bir bölümüdür. Issue'lar, pull request'ler, kullanıcılar ve key'ler veritabanında tutulur. Yerleşik dump özelliği olan sudo -u git forgejo dump -c /etc/forgejo/app.ini kullanılmalı veya Docker kurulumu için aynı komut container içinde çalıştırılmalıdır. Arşiv sunucu dışına kopyalanmalıdır. İşlemin çalıştığından emin olmak için arşivlerden biri bir kez yedek bir makineye geri yüklenmelidir.

Bu yazı işinize yaradı mı?

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