SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Server Git Self-Hosted: Forgejo, Gitea, atau cgit

Bandingkan 4 cara menjalankan server Git self-hosted berdasarkan RAM: bare repository via SSH, cgit, Forgejo atau Gitea, dan GitLab. Lihat pilihan untuk VPS 1 GB.

Server Git self-hosted mana yang sebaiknya Anda jalankan

Server Git self-hosted bukan hanya satu produk, dan RAM (random access memory) pada VPS menentukan versi yang dapat Anda gunakan. Git tidak memerlukan daemon sendiri: bare repository dan akun SSH (secure shell) sudah cukup untuk menyediakan server yang berfungsi pada VPS terkecil yang dapat Anda sewa. Semua pilihan di atas tingkat tersebut adalah aplikasi web yang Anda jalankan di sampingnya. Setiap peningkatan tingkat memerlukan memori tambahan yang mungkin tidak tersedia pada VPS kecil. Jika Anda masih belum yakin di mana Git berakhir dan GitHub dimulai, perbedaan antara Git, GitHub, dan server Git milik Anda sendiri menjelaskan pembagian tersebut sebelum Anda memilih tingkat.

Ada empat tingkat. Bare repository melalui SSH, tanpa proses tambahan yang listening selain proses yang memang sudah listening. cgit, tampilan web read-only yang cepat tanpa database. Forgejo atau Gitea, forge lengkap dengan akun, issue, dan pull request dalam beberapa ratus megabyte. GitLab, yang memerlukan server dengan ukuran berkali-kali lipat dibandingkan pilihan lainnya.

Tentukan pilihan berdasarkan pekerjaan yang perlu Anda lakukan, lalu bandingkan kebutuhan memori tersebut dengan kapasitas pada paket yang Anda bayar.

Kebutuhan RAM sebenarnya untuk setiap opsi

Hanya dua dari proyek ini yang menerbitkan angka kebutuhan perangkat keras. Anggap angka yang diterbitkan sebagai batas minimum, bukan jaminan. Ukur instance Anda sendiri setelah berjalan dengan systemd-cgtop atau ps -o rss= -C forgejo.

GrafikRAM the projects document, official docs, October 2026
Data di balik grafik ini
[
  {
    "label": "Gitea, small team",
    "ram_gb": 1
  },
  {
    "label": "GitLab, memory constrained",
    "ram_gb": 8
  },
  {
    "label": "GitLab, single node baseline",
    "ram_gb": 16
  }
]

Gitea mendokumentasikan 1 GB RAM dengan 2 core CPU sebagai kebutuhan yang biasanya cukup untuk tim dan proyek kecil. Gitea juga menyebut Raspberry Pi 3 cukup untuk beban kerja kecil. GitLab mendokumentasikan 16 GB sebagai baseline untuk instalasi satu node, dan 8 GB sebagai batas bawah untuk kondisi yang disebut halamannya sendiri sebagai lingkungan dengan keterbatasan memori. Dokumentasi instalasi Forgejo tidak mencantumkan angka kebutuhan RAM. Forgejo adalah fork dari Gitea dan berperilaku serupa, sehingga angka Gitea merupakan panduan yang paling relevan.

Pada VPS 1 GB, repositori bare dan cgit dapat berjalan dengan sisa sumber daya karena keduanya tidak menjalankan service yang menetap. Forgejo atau Gitea akan start dan dapat melayani tim kecil menggunakan SQLite. Namun, Anda berada tepat pada batas minimum yang didokumentasikan. Karena itu, jangan jalankan PostgreSQL dan runner CI (continuous integration) pada server tersebut. Jika antarmuka web menghilang tanpa pesan error, jalankan sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' dan cari baris seperti Out of memory: Killed process 1181 (forgejo). Baris tersebut berarti kernel menjalankan out-of-memory killer terhadap proses itu. GitLab pada server 1 GB bukan masalah tuning. GitLab tidak akan berjalan.

Tier 0: repositori bare melalui SSH

Git tidak memiliki daemon jaringan yang perlu Anda jalankan. git push melalui SSH menjalankan git-receive-pack di sisi tujuan sebagai proses Unix biasa. Jadi, akun apa pun yang dapat Anda akses dengan key sudah menjadi remote Git. Buat satu akun untuk repositori, lalu simpan repositori di luar direktori home akun tersebut. Dengan begitu, tampilan web yang ditambahkan nanti tidak perlu mengakses direktori home itu.

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 membuat repositori tanpa working copy. Inilah jenis repositori yang disimpan server. Push ke branch yang sedang di-checkout pada repositori yang memiliki working copy secara default ditolak dengan refusing to update checked out branch: refs/heads/main. Ini adalah kesalahan yang paling umum pada tier ini.

Selanjutnya, berikan key kepada akun tersebut dan lakukan 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 pertama yang berhasil diakhiri dengan * [new branch] main -> main. Push yang diakhiri dengan git@vps.example.com: Permission denied (publickey) tidak pernah melalui autentikasi. Karena itu, baca log server dengan sudo journalctl -u ssh -n 20. Baris yang berisi Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys berarti ownership atau file mode salah. sshd menolak file key jika owner-nya tidak tepercaya atau izinnya memungkinkan pengguna lain menulis file tersebut.

Jika origin proyek sudah mengarah ke GitHub, git remote add origin berhenti dengan error: remote origin already exists.. Menambahkan server ini sebagai push URL kedua pada remote tersebut memungkinkan satu git push memperbarui keduanya.

Selanjutnya, hapus akses shell dari akun tersebut.

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

git-shell hanya menerima beberapa perintah yang dikirim Git melalui SSH. Karena itu, login interaktif sekarang berhenti dengan pesan, bukan prompt:

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

Itulah keseluruhan server. Tidak ada database dan tidak ada proses web yang perlu di-upgrade. Konsekuensinya, Anda tidak mendapatkan fitur yang disediakan forge: tidak ada penelusuran repositori, issue tracker, pull request, atau izin per pengguna. Setiap key dalam file tersebut dapat membaca dan menulis setiap repositori yang dimiliki pengguna git.

Tingkat 1: cgit menyediakan tampilan web tanpa database

cgit adalah program CGI (common gateway interface) yang ditulis dalam C. Server web menjalankannya sekali untuk setiap permintaan, membaca repositori langsung dari disk, dan tidak menyimpan state sendiri. Ubuntu 24.04 menyertakannya dalam komponen universe.

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

Arahkan program tersebut ke direktori repositori dalam /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 menelusuri direktori tersebut dan mencantumkan setiap repositori yang ditemukan. Dengan demikian, bare repo baru akan muncul tanpa konfigurasi tambahan. cache-size adalah jumlah halaman yang disimpan dalam cache, dan caching tetap nonaktif selama nilainya nol. Baca isi /etc/cgitrc yang sudah dibuat oleh paket sebelum menambahkan baris, karena paket Debian dan Ubuntu menyediakan beberapa default sendiri.

Setiap entri menampilkan baris pertama dari file description milik repositori. Karena itu, bare repo baru akan ditampilkan sebagai Unnamed repository; edit this file 'description' to name the repository.. Perbaiki hal tersebut satu kali untuk setiap repositori:

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
File site nginx dan cara memeriksanya
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 menyajikan cgit.css dan cgit.png sebagai file biasa, sedangkan try_files meneruskan permintaan lainnya ke CGI pada /usr/lib/cgit/cgit.cgi. Halaman 502, dengan connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) di dalam /var/log/nginx/error.log, berarti unit socket tidak berjalan atau mendengarkan pada path lain. Baris systemctl show mencetak path yang benar-benar digunakan.

Ada dua batasan yang perlu diketahui sebelum Anda menggunakannya lebih lanjut. cgit bersifat read-only dan tidak memiliki login dalam konfigurasi ini, sehingga semua yang berada di bawah scan-path bersifat publik. Jangan menempatkan repositori privat di direktori tersebut, atau pasang autentikasi dasar HTTP di depan seluruh site. Selain itu, CGI berjalan sebagai user server web, sehingga user tersebut harus dapat menelusuri /srv/git dan membaca setiap repositori. Direktori yang tidak dapat dimasuki user tersebut akan ditampilkan sebagai indeks kosong, bukan sebagai error.

Tier 2: Forgejo atau Gitea untuk issue dan pull request

Forgejo dan Gitea memiliki konsep yang sama: satu binary Go yang menyajikan web forge dengan fitur pengguna, organisasi, issue, pull request, rilis, registri paket, dan sistem CI bawaan. Binary ditambah SQLite adalah keseluruhan instalasi, itulah sebabnya keduanya cocok pada perangkat keras yang tidak dapat dijalankan oleh GitLab. File Compose di bawah ini adalah file yang ada dalam dokumentasi Forgejo, dengan tag image yang disebutkan per 24 Oktober 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 tersebut mengikuti lini v17. Forgejo v17.0.1, yang dirilis pada 26 Oktober 2026, adalah rilis stabil saat ini, dan Forgejo mendukung v17 hingga 28 Januari 2027. Lini v16 yang lebih lama kehilangan dukungan pada 29 Oktober 2026, jadi instalasi yang ada dan masih menggunakan tag 16 perlu segera ditingkatkan. Beralih dari satu versi mayor ke versi berikutnya di kemudian hari adalah peningkatan manual, jadi lebih hemat untuk memulai dari versi saat ini.

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

Baris curl seharusnya mencetak baris status HTTP. Sebelum Anda menyelesaikan pengaturan awal, mungkin akan muncul redirect ke /install, yang tetap berarti layanan tersebut aktif. Jika container malah keluar (exit), penyebab umumnya adalah kepemilikan: direktori ./forgejo harus dimiliki oleh UID (user id) di USER_UID, atau proses tersebut tidak dapat menulis ke direktori datanya sendiri. Docker Compose pada VPS membahas tata letak file tersebut dan aturan kepemilikan volume secara lengkap.

Dua jawaban pada halaman pengaturan menentukan apakah URL clone berfungsi. Port SSH harus berupa sisi host dari pemetaan SSH, yang dalam file Compose di atas adalah 222, karena memetakan port host 222 ke port 22 container. Tidak ada keharusan menggunakan 222 itu sendiri: port host yang bebas mana pun bisa digunakan, selama pemetaan dan jawaban ini sesuai. Dan domain harus berupa nama yang akan diketik oleh orang-orang. Jika salah satu salah, setiap halaman repositori akan menawarkan perintah clone yang gagal bagi siapa pun yang menyalinnya. Keduanya berada di bagian [server] dari app.ini setelahnya, sebagai SSH_PORT, SSH_DOMAIN, dan ROOT_URL.

Untuk instance publik, publikasikan port web hanya pada alamat loopback ('127.0.0.1:3000:3000') dan tempatkan nginx di depannya untuk TLS (transport layer security). Gitea diinstal dengan cara yang sama dari image docker.gitea.com/gitea yang digunakan dokumentasinya, atau sebagai binary tunggal dengan satu unit systemd dan satu app.ini. Rilis stabil saat ini adalah v28.4.0, yang diterbitkan pada 15 November 2026. Dengan v28.0.0 pada akhir September, proyek tersebut menghapus awalan 1. yang lama, jadi rilis setelah 1.27 adalah 28, bukan 1.28.

Tetap gunakan SQLite selama Anda bisa. Ini menjaga instance tetap pada satu proses dan satu file, serta dapat bertahan setelah reboot tanpa layanan tambahan untuk diawasi. PostgreSQL sepadan dengan biayanya ketika beberapa orang menulis secara bersamaan, karena SQLite melakukan serialisasi penulisan dan proses CI yang panjang terus-menerus melakukan penulisan. Kedua proyek dapat memindahkan instance yang ada ke PostgreSQL di kemudian hari, jadi ini bukan keputusan yang mengikat Anda selamanya.

Forgejo atau Gitea: apa perbedaan sebenarnya

Silsilahnya sama. Gitea melakukan fork dari Gogs pada tahun 2016. Pada akhir 2022, kendali atas domain dan merek dagang Gitea beralih ke sebuah perusahaan, Gitea Ltd, dan beberapa maintainer bersama Codeberg memulai Forgejo. Forgejo dikembangkan oleh komunitasnya di bawah naungan Codeberg e.V., sebuah asosiasi nirlaba yang terdaftar di Jerman yang memegang domain proyek tersebut, sementara tata kelola tetap berada di tangan kontributor Forgejo sendiri. Proyek ini beralih dari lisensi MIT ke GPLv3 (GNU general public license version 3) pada tahun 2024. Gitea tetap menggunakan lisensi MIT dan dikembangkan dengan dukungan komersial di belakangnya.

Sehari-hari, set fiturnya sangat mirip. Namun, jalur perpindahan di antara keduanya tidak. Forgejo v10.0, dari Januari 2025, adalah rilis terakhir yang dapat mengambil database Gitea secara langsung, dan hanya dari Gitea v1.22 atau yang lebih lama. Gitea berada di v28.4.0 per 16 November 2026, jadi instance Gitea saat ini tidak memiliki dukungan perpindahan langsung ke Forgejo. Pilih salah satu sebelum Anda mengisinya dengan data, dan anggap perpindahan di kemudian hari sebagai ekspor dan impor ulang.

Aturan singkat untuk memilih. Jika tata kelola penting bagi Anda, atau Anda menginginkan proyek di bawah naungan nirlaba, jalankan Forgejo. Jika Anda menginginkan basis instalasi yang lebih besar dan opsi dukungan komersial, jalankan Gitea. Keduanya dikelola secara terbuka dan sering merilis pembaruan: Forgejo merilis rilis stabil setiap tiga bulan dan rilis LTS (long term support) setiap tahun, dengan v17.0.1 sebagai versi saat ini dan v15.0.11 sebagai LTS per 29 Oktober 2026. Forgejo mendukung v17 hingga 28 Januari 2027 dan v15 hingga 15 Juli 2027, sementara dukungan v16 berakhir pada 29 Oktober 2026, jadi periksa halaman rilisnya sebelum Anda mengunci versi mayor. Jika tidak ada aturan yang menentukan, perbandingan lengkap Forgejo dan Gitea menjelaskan bagaimana Actions dan registri paket mereka berbeda, dan itulah detail yang harus diselesaikan sebelum data Anda membuat perpindahan menjadi mahal.

Tingkat 3: biaya GitLab sebelum melakukan apa pun

GitLab CE adalah kelas perangkat lunak yang berbeda. Satu instance terdiri atas sekumpulan service yang bekerja sama: Puma untuk aplikasi web, Sidekiq untuk pekerjaan latar belakang, PostgreSQL, Redis, Gitaly untuk akses repository, dan nginx di bagian depan. Paket Omnibus memasang semuanya secara bersamaan. Hal ini menyederhanakan instalasi, tetapi kebutuhan memori minimumnya menjadi tinggi.

Halaman persyaratan GitLab mencantumkan 16 GB RAM dan 8 vCPU sebagai baseline untuk instalasi single-node, dengan 8 GB disebut sebagai batas bawah dalam lingkungan dengan memori terbatas. Halaman yang sama menyarankan Anda menonaktifkan swap karena swapping saat beban tinggi sangat menurunkan kinerja instance. Angka tersebut adalah angka yang dipublikasikan per Oktober 2026 dan terus meningkat selama beberapa tahun terakhir. Karena itu, baca kembali halaman tersebut sebelum menentukan ukuran server.

Dengan anggaran tersebut, Anda memperoleh fitur nyata: container registry, package registry, permission terperinci, dan CI yang telah diuji pada skala besar. Compliance center serta audit trail project atau group memerlukan GitLab tier berbayar. Jika tidak ada seorang pun di tim Anda yang dapat menyebutkan fitur dari daftar tersebut yang mereka perlukan pada kuartal ini, Anda hanya membayar VPS yang lebih besar tanpa memperoleh manfaat.

Model akses SSH: satu pengguna git dan banyak kunci

Dengan OpenSSH sistem, setiap tingkat di sini menggunakan cara autentikasi yang sama. Ada satu akun Unix bernama git, dan setiap kunci publik disimpan dalam ~/.ssh/authorized_keys milik akun tersebut. Kunci digunakan untuk autentikasi. Otorisasi ditentukan oleh opsi yang ditulis di depan kunci pada baris yang sama.

Baris kunci biasa memberikan kepada pemegangnya semua kemampuan yang dimiliki akun tersebut. Untuk akun yang masih menggunakan /bin/bash sebagai shell login, perintah paksa membatasi aksesnya ke Git:

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

restrict, yang tersedia sejak OpenSSH 7.2, menonaktifkan penerusan port, penerusan agen, X11, dan alokasi PTY (pseudo terminal) dengan satu kata. command= mengganti perintah yang diminta klien dengan perintah yang Anda tentukan, dan Git tetap berfungsi karena server SSH menempatkan perintah asli dari klien dalam $SSH_ORIGINAL_COMMAND.

Forge menulis file tersebut untuk Anda, dan di situlah perbedaan utama antara tingkat 0 dan tingkat 2. Jika Forgejo dan Gitea menggunakan server OpenSSH sistem, yang merupakan konfigurasi default-nya, keduanya menulis ulang authorized_keys dengan satu baris untuk setiap kunci terdaftar. Setiap baris berisi perintah paksa yang mengidentifikasi kunci berdasarkan ID-nya dalam 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

Perintah paksa tersebut mengubah satu akun Unix bersama menjadi izin per pengguna: key-3 memberi tahu forge pengguna yang sedang terhubung, lalu forge memeriksa pengguna tersebut terhadap repositori sebelum objek apa pun dipindahkan. Jangan mengedit file tersebut secara manual pada server yang dikelola forge, karena file itu ditulis ulang dari database dan baris Anda akan hilang. Jika Anda mengaktifkan server SSH bawaan forge, atau meminta OpenSSH mengambil kunci dari forge melalui AuthorizedKeysCommand, forge tidak memerlukan file tersebut sama sekali. Dalam kasus kedua, kedua proyek menyarankan agar pembuatan file itu dinonaktifkan. Deploy key menggunakan mekanisme yang sama: deploy key adalah kunci SSH biasa yang didaftarkan pada satu repositori, biasanya hanya-baca, dengan pemeriksaan yang dilakukan oleh forge, bukan oleh sshd.

Dua kebiasaan lebih penting daripada konfigurasi di atas. Buat satu kunci untuk setiap orang atau mesin, jangan gunakan kunci bersama, karena mencabut kunci bersama berarti menggantinya untuk semua orang sekaligus. Hapus kunci pada hari seseorang keluar, karena kunci lama dalam file tersebut menjadi akses login permanen yang tidak diawasi. Manajemen kunci SSH yang baik di server membahas jenis kunci dan frasa sandi, dan semuanya berlaku di sini tanpa perubahan. Jika server masih baru, sepuluh menit pertama pada VPS baru adalah langkah yang tepat sebelum Anda menempatkan repositori di dalamnya.

Dapatkah saya menjalankan GitHub Actions pada server Git milik sendiri?

Anda dapat menjalankan workflow yang ditulis dengan sintaks GitHub Actions. Namun, Anda tidak dapat menjalankan GitHub. Forgejo Actions telah diaktifkan secara default sejak Forgejo v1.21 dan membaca file workflow dari .forgejo/workflows di setiap repositori. Gitea Actions bekerja dengan cara yang sama dan membaca .gitea/workflows. Keduanya memerlukan program kedua, yaitu runner, yang harus diinstal dan didaftarkan ke instance Anda menggunakan token dari pengaturan admin. Banyak action yang dipublikasikan dapat dijalankan tanpa perubahan.

Perhatikan dua konsekuensinya. Dengan label container yang umum digunakan, runner memulai satu container untuk setiap job. Karena itu, runner memerlukan container engine dan alokasi memori sendiri. Inilah alasan runner tidak sebaiknya ditempatkan pada server 1 GB yang sama dengan forge. Kedua runner juga dapat menjalankan job secara langsung pada host, melalui label yang diakhiri dengan :host di Forgejo. Cara ini tidak memerlukan engine, tetapi juga tidak menyediakan container sebagai pembatas antara job dan mesin tersebut. Runner menjalankan apa pun yang ditentukan oleh file workflow. Dokumentasi Forgejo menyatakannya secara langsung: runner melakukan remote code execution. Jika memungkinkan, tempatkan runner pada host tersendiri. Setidaknya, gunakan user unprivileged tersendiri dan registration token yang dibatasi untuk satu repositori.

Jika repositori Anda tetap berada di GitHub dan Anda hanya ingin menjalankan komputasi pada hardware yang Anda kendalikan, konfigurasinya berbeda dan langkahnya juga berbeda: runner GitHub Actions self-hosted terhubung ke repositori GitHub dan tidak memerlukan semua hal tersebut. Jika Anda masih mempertimbangkan konsekuensi meninggalkan GitHub, apa yang sebenarnya diberikan GitHub kepada Anda memisahkan layanan Git hosting dari jaringan di sekitarnya.

Backup: repositori hanya mencakup sebagian keadaan

Bare repository adalah direktori, sehingga menyalinnya berarti menyalin seluruh isinya. Mirror clone dari mesin lain merupakan backup yang sebenarnya dan dapat diperbarui di tempat:

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

Perintah tersebut menarik setiap ref dan setiap objek. Perintah tersebut tidak menarik hook di sisi server atau file description, jadi simpan juga salinan direktori pada tingkat file jika Anda menggunakan hook.

Forge menyimpan issue, pull request, pengguna, key, dan izin di dalam databasenya. Menyalin repositori saja akan menghilangkan semua data tersebut. Kedua project menyediakan perintah dump yang menulis database, repositori, konfigurasi, dan lampiran ke dalam satu arsip:

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

Di dalam Docker, perintah yang sama dijalankan di dalam container. Path konfigurasi bergantung pada image, jadi periksa terlebih dahulu sebelum mengetik:

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

Jalankan perintah tersebut sebagai pengguna yang memiliki data dan tulis arsip ke direktori yang dapat ditulis oleh pengguna tersebut. Kemudian salin arsip keluar dari server, karena backup yang hanya ada pada mesin yang sedang dicadangkan bukanlah backup. Pemulihan adalah langkah yang sering dilewati. Bongkar satu dump ke mesin cadangan sekarang, agar Anda memahami prosedurnya pada saat yang tenang, bukan ketika terjadi outage.

Pilih berdasarkan skenario

Satu orang dengan laptop dan VPS, tanpa perlu penelusuran melalui browser: gunakan bare repository melalui SSH. Tidak ada service tambahan yang berjalan dan tidak ada yang perlu diperbarui.

Kondisinya sama, tetapi Anda ingin membaca kode di browser dan membagikan tautan ke kode tersebut: tambahkan cgit. Tetap tidak memerlukan database dan tidak ada service yang terus berjalan.

Tim yang saling meninjau kode dan melacak issue: gunakan Forgejo atau Gitea, dengan RAM minimal 2 GB. Pindahkan CI runner ke server kedua setelah job mulai membutuhkan sumber daya yang besar.

Organisasi yang memerlukan container registry dan audit trail, dengan anggaran server sebesar 16 GB RAM: gunakan GitLab. Jika anggaran di bawah itu, jangan jalankan GitLab.

Beralih ke salah satu dari tiga tingkat pertama tidak mahal karena repository pada ketiganya adalah direktori Git biasa di disk. Mulailah dari tingkat terendah yang memenuhi kebutuhan. Jika Anda sedang menentukan layanan lain yang layak menggunakan ruang pada server yang sama, daftar singkat layanan yang layak di-self-host menempatkan server Git di samping layanan lain yang bersaing menggunakan RAM tersebut.

FAQ

Apakah VPS 1 GB dapat menjalankan Forgejo atau Gitea?

Ya, untuk tim kecil, dengan SQLite, dan tanpa beban berat lain pada server tersebut. Dokumentasi Gitea menyebutkan bahwa 1 GB RAM dan 2 core CPU biasanya cukup untuk tim dan proyek kecil. Forgejo merupakan fork Gitea dengan kebutuhan yang serupa. Jangan menambahkan PostgreSQL atau runner CI ke mesin tersebut. Jika service berhenti tanpa error pada lognya sendiri, jalankan sudo dmesg -T | grep -Ei 'oom|out of memory|killed process'. Baris yang menyebutkan proses yang dihentikan berarti kernel menjalankan out-of-memory killer. Solusinya adalah menggunakan paket yang lebih besar, bukan mengubah flag tuning.

Apa perbedaan antara Forgejo dan Gitea?

Keduanya memiliki riwayat codebase yang sama dan sebagian besar fitur yang sama. Gitea merupakan fork dari Gogs pada 2016. Forgejo merupakan fork dari Gitea pada akhir 2022 setelah kendali atas merek dagang Gitea berpindah ke sebuah perusahaan. Forgejo dikembangkan oleh komunitasnya di bawah naungan Codeberg e.V., organisasi nirlaba di Jerman, dan dirilis dengan lisensi GPLv3. Gitea tetap menggunakan lisensi MIT dengan dukungan komersial. Perbedaan praktisnya terletak pada jalur migrasi. Forgejo v10.0, yang dirilis pada Januari 2025, merupakan release terakhir yang dapat menggunakan database Gitea secara langsung, dan hanya dari Gitea v1.22 atau yang lebih lama. Karena itu, instance Gitea saat ini tidak memiliki metode perpindahan in-place yang didukung.

Dapatkah saya menjalankan workflow GitHub Actions pada server Git yang di-host sendiri?

Forgejo Actions dan Gitea Actions sama-sama menjalankan workflow yang ditulis dengan sintaks YAML GitHub Actions. Keduanya membaca workflow dari .forgejo/workflows dan .gitea/workflows. Anda perlu menginstal program runner terpisah dan mendaftarkannya ke instance Anda. Banyak action yang dipublikasikan dapat digunakan tanpa perubahan. Runner menjalankan kode arbitrer dari repository Anda dan, dengan label container yang umum digunakan, memulai satu container untuk setiap job. Karena itu, gunakan host tersendiri, atau setidaknya user unprivileged tersendiri. Jangan jalankan runner pada server 1 GB yang sudah menjalankan forge.

Bagaimana cara mencadangkan server Git yang di-host sendiri?

Untuk repository bare, git clone --mirror dari mesin lain menyalin setiap ref dan object. git remote update di dalam mirror tersebut akan memperbaruinya. Untuk Forgejo atau Gitea, repository hanya mencakup sebagian state. Issue, pull request, user, dan key tersimpan di dalam database. Gunakan dump bawaan melalui sudo -u git forgejo dump -c /etc/forgejo/app.ini, atau jalankan command yang sama di dalam container untuk instalasi Docker. Salin archive ke luar server. Kemudian pulihkan salah satu archive ke mesin cadangan satu kali untuk memastikan prosedurnya berfungsi.

Apakah artikel ini bermanfaat?

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