İçeriğe geç
zefıly
← Tüm yazılar

Gitea'yı kendi sunucunuzda çalıştırmak: Docker ile kendi Git sunucunuz

5 dk okuma

Gitea, küçük bir sunucuda çalıştırabileceğiniz hafif bir Git barındırma hizmetidir. Docker ile nasıl başlatılır, kurulum sayfasında doğru yapılması gereken ayarlar, yabancıların kaydolması nasıl engellenir, SSH kullanılmalı mı ve nasıl yedeklenir.

Gitea, çoğu ekibin bir Git barındırma hizmetinden beklediğini verir: depolar, birleştirme istekleri, kayıtlar (issue), paket deposu ve CI (Gitea Actions). Tek ve küçük bir programdır; GitLab'i taşıyamayacak bir sunucuda rahat çalışır.

Buradaki komutları 12 Kasım 2026'da resmi gitea/gitea:latest imajıyla denedik.

Kısaca

  • Tek kapsayıcı, tek birim (/data). Varsayılan SQLite; veritabanı sunucusu gerekmez.
  • Boşta duran kapsayıcımız yaklaşık 85 MB bellek kullandı.
  • İlk başlangıçtan önce ROOT_URL değerini genel HTTPS adresinize ayarlayın.
  • İlk kaydolan kullanıcı yönetici olur. Hemen kaydolun, sonra kaydı kapatın.
  • SSH konusunda karar verin: erişim belirteçleriyle HTTPS daha basittir, SSH kendi portunu ister.
  • gitea dump ile ya da birimi kopyalayarak yedekleyin.

1. Kapsayıcıyı başlatın

docker volume create gitea_data

docker run -d --name gitea --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -e GITEA__server__ROOT_URL=https://git.example.com/ \
  -e GITEA__server__DISABLE_SSH=true \
  -v gitea_data:/data \
  docker.io/gitea/gitea:latest

Ayarlar GITEA__bölüm__ANAHTAR biçiminde ortam değişkeni olarak verilebilir. Gitea bunları başlarken yapılandırma dosyasına yazar. Sonucu /data/gitea/conf/app.ini içinde kontrol ettik:

ROOT_URL = https://git.example.com/
DISABLE_SSH = true
  • ROOT_URL, Gitea'nın klon adreslerine, e-postalara ve bağlantılara yazdığı adrestir. Yanlışsa klon düğmesi kimsenin ulaşamayacağı bir adres gösterir.
  • DISABLE_SSH=true, SSH klon adreslerini gizler. Seçimi aşağıda açıklıyoruz.
  • Canlı kullanım için :latest yerine sabit bir sürüm etiketi yazın ve bilerek güncelleyin.

2. Ters vekil

server {
    server_name git.example.com;
    client_max_body_size 512M;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

client_max_body_size önemlidir: HTTPS üzerinden git push veriyi tek bir istek olarak gönderir ve nginx'in 1 MB'lık varsayılan sınırı daha büyük her şeyi 413 Request Entity Too Large ile reddeder.

3. Kurulum sayfası

İlk ziyaret Kurulum sayfasını gösterir. Değerlerin çoğu zaten doğrudur. Şunlara bakın:

  • Veritabanı türü: SQLite3 varsayılandır ve bir ekip için yeterlidir. Çok kullanıcı bekliyorsanız PostgreSQL ya da MariaDB seçin.
  • Sunucu alan adı ve temel adres: genel adresinizle eşleşmelidir.
  • Yönetici hesabı: burada doldurun. Boş bırakırsanız ilk kaydolan kullanıcı yönetici olur.

Kapsayıcıyı başlattıktan hemen sonra siteyi açıp bu sayfayı tamamlayın. Siz tamamlayana kadar adresi bulan herkes kurulumu bitirebilir.

4. Kaydı kapatın

Varsayılan olarak herkes Gitea'nızda hesap açabilir. Özel bir sunucu için bunu kapatın. Kapsayıcıya ekleyin:

-e GITEA__service__DISABLE_REGISTRATION=true

ve diğer kullanıcıları site yönetiminden kendiniz oluşturun. Depolar da özelse şunu da ekleyin:

-e GITEA__service__REQUIRE_SIGNIN_VIEW=true

Böylece giriş yapmamış ziyaretçiler hiçbir şey görmez.

5. Git için HTTPS mi, SSH mi?

HTTPS, zaten var olan web sunucunuz üzerinden çalışır. Kullanıcılar Gitea ayarlarından bir erişim belirteci oluşturur ve parola olarak onu kullanır. Açılacak başka bir şey yoktur.

SSH, birçok geliştiricinin alışık olduğu yoldur; ama kapsayıcının SSH sunucusu sunucuda kendi portunu ister ve 22 numaralı port sunucunun kendi SSH'ı tarafından kullanılır. Başka bir porttan (örneğin 2222) yayınlamanız, o portu güvenlik duvarında açmanız ve Gitea'ya bildirmeniz gerekir.

Küçük bir ekip için HTTPS ve belirteçlerle başlayın. Biri eksikliğini duyarsa SSH'ı sonra eklersiniz.

6. Birimde neler var

git  gitea  ssh
  • git/: depolar.
  • gitea/: yapılandırma (conf/app.ini), SQLite veritabanı, ekler, avatarlar, paketler, günlükler.
  • ssh/: kapsayıcının SSH sunucu anahtarları.

app.ini gizli değerler içerir (SECRET_KEY, INTERNAL_TOKEN). Bu birimin yedeklerini gizli sayın.

7. Yedekler

Gitea'nın kendi döküm komutu vardır; veritabanını, depoları ve yapılandırmayı tek bir arşive yazar:

docker exec -u git -w /tmp gitea gitea dump -c /data/gitea/conf/app.ini

Ya da kapsayıcıyı durdurup bütün birimi kopyalayın:

docker stop gitea
docker run --rm -v gitea_data:/data -v "$PWD":/backup alpine \
  tar czf /backup/gitea-$(date +%F).tar.gz -C /data .
docker start gitea

Hangisini seçerseniz seçin, sonucu sunucunun dışına kopyalayın. Her geliştiricinin klonu kodun bir kopyasıdır; ama kayıtların, birleştirme isteklerinin ve ayarların değil.

8. Güncellemeler

docker pull docker.io/gitea/gitea:<yeni sürüm>
docker stop gitea && docker rm gitea
# aynı docker run komutunu yeni etiketle çalıştırın

Gitea başlarken veritabanını kendisi taşır. Önce yedek alın; taşımadan sonra eski sürüme dönmek o yedeği geri yüklemek demektir.

Zefily ile

Gitea, Zefily'de tek tıkla kurulan bir uygulamadır: sitenin kendi Linux kullanıcısı altında yetkisiz (rootless) bir kapsayıcı, 127.0.0.1 üzerinde, HTTPS'li web sunucusunun arkasında; ROOT_URL alan adınıza ayarlı, verisi güncellemelerden etkilenmeyen bir birimde. SSH üzerinden Git kapalıdır; HTTPS kullanırsınız. Siz kurulum sayfasını tamamlayana kadar site parola korumalıdır. Konteyner uygulamaları belgesine bakın.

Sık sorulan sorular

Gitea ne kadar sunucu ister?

Az. Boşta duran Gitea kapsayıcımız yaklaşık 85 MB bellek kullandı ve veritabanı sunucusu olmadan SQLite ile çalışır.

Gitea yöneticisi kim olur?

Kurulum sayfasında girilen hesap; girilmediyse ilk kaydolan kullanıcı. Kapsayıcıyı başlattıktan hemen sonra kurulumu tamamlayın.

Gitea'da kaydı nasıl kapatırım?

GITEA__service__DISABLE_REGISTRATION=true ayarlayın (app.ini dosyasının service bölümünde DISABLE_REGISTRATION) ve yeniden başlatın.

git push, nginx arkasında neden 413 ile başarısız oluyor?

nginx istek gövdelerini varsayılan olarak 1 MB ile sınırlar. Sitenin server bloğunda client_max_body_size değerini yükseltin.

Gitea için SSH gerekli mi?

Hayır. Erişim belirteciyle HTTPS üzerinden Git, web sunucunuz üzerinden çalışır. SSH, kapsayıcıdan ek bir port yayınlamayı gerektirir.

Zefily ile kendi imajlarınızı çalıştırmak için Konteynerler belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →