SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-10-30

Self-hosted Git server হিসেবে Forgejo, Gitea নাকি cgit?

চারটি self-hosted Git server পদ্ধতি RAM অনুযায়ী তুলনা করুন: SSH bare repository, cgit, Forgejo বা Gitea, এবং GitLab। 1 GB VPS-এ কোনটি চলবে জানুন।

কোন self-hosted Git server চালাবেন

Self-hosted Git server কোনো একক product নয়, এবং আপনার VPS-এর RAM (random access memory) নির্ধারণ করে আপনি এর কোন সংস্করণ চালাতে পারবেন। Git-এর নিজস্ব কোনো daemon প্রয়োজন হয় না: আপনি ভাড়া নিতে পারেন এমন সবচেয়ে ছোট box-এও একটি bare repository এবং একটি SSH (secure shell) account থাকলেই কার্যকর server তৈরি হয়। এর ওপরে যা আছে, সেগুলো হলো তার পাশাপাশি চালানোর জন্য আপনার বেছে নেওয়া web application; প্রতিটি উচ্চতর ধাপে এমন memory প্রয়োজন হয়, যা একটি ছোট VPS-এ নাও থাকতে পারে। Git কোথায় শেষ হয় এবং GitHub কোথায় শুরু হয় তা নিয়ে এখনও অনিশ্চিত থাকলে, Git, GitHub এবং আপনার নিজস্ব Git server-এর পার্থক্য কোনো tier বেছে নেওয়ার আগে এই বিভাজনটি ব্যাখ্যা করে।

চারটি ধাপ আছে। SSH-এর মাধ্যমে একটি bare repository, যেখানে আগে থেকেই listening করা ছিল না এমন কিছুই listening করছে না। cgit, কোনো database ছাড়া দ্রুত read-only web view। Forgejo বা Gitea, accounts, issues এবং pull requests-সহ কয়েকশো megabyte-এ চলতে পারে এমন একটি পূর্ণ forge। GitLab, যা অন্যগুলোর তুলনায় বহুগুণ বড় server প্রত্যাশা করে।

আপনার যে কাজ করতে হবে, তার ভিত্তিতে সিদ্ধান্ত নিন। এরপর আপনি যে plan-এর জন্য অর্থ দিচ্ছেন, তার সঙ্গে memory-এর পরিমাণ মিলিয়ে দেখুন।

প্রতিটি বিকল্পের আসলে কত RAM প্রয়োজন

এই প্রকল্পগুলোর মধ্যে মাত্র 2টি hardware figure প্রকাশ করে। প্রকাশিত figure-কে নিশ্চয়তা নয়, বরং ন্যূনতম সীমা হিসেবে ধরুন। Instance চালু হওয়ার পরে systemd-cgtop বা ps -o rss= -C forgejo ব্যবহার করে নিজের instance-এর ব্যবহার মাপুন।

চার্টRAM the projects document, official docs, October 2026
এই চার্টের পেছনের ডেটা
[
  {
    "label": "Gitea, small team",
    "ram_gb": 1
  },
  {
    "label": "GitLab, memory constrained",
    "ram_gb": 8
  },
  {
    "label": "GitLab, single node baseline",
    "ram_gb": 16
  }
]

ছোট team ও project-এর জন্য সাধারণত 1 GB RAM এবং 2টি CPU core যথেষ্ট বলে Gitea-এর documentation-এ উল্লেখ আছে। ছোট workload-এর জন্য Raspberry Pi 3 যথেষ্ট বলেও সেখানে উল্লেখ করা হয়েছে। একটি single-node installation-এর baseline হিসেবে GitLab 16 GB উল্লেখ করে। তাদের নিজেদের ভাষায় memory constrained environment-এর নিম্নসীমা হিসেবে 8 GB উল্লেখ করা হয়েছে। Forgejo-এর installation documentation-এ RAM-এর কোনো figure দেওয়া নেই। এটি Gitea-এর fork এবং একইভাবে কাজ করে। তাই আপনার কাছে থাকা সবচেয়ে কাছের published guide হলো Gitea-এর figure।

1 GB VPS-এ এর অর্থ হলো bare repository এবং cgit অতিরিক্ত RAM রেখেই চলবে, কারণ কোনোটিই resident service চালায় না। Forgejo বা Gitea চালু হবে এবং SQLite ব্যবহার করে ছোট team-কে service দিতে পারবে। তবে আপনি documented floor-এ আছেন। তাই ওই box-এ PostgreSQL এবং CI (continuous integration) runner চালু রাখবেন না। কোনো error ছাড়াই web interface অদৃশ্য হলে sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' চালান এবং Out of memory: Killed process 1181 (forgejo)-এর মতো কোনো line খুঁজুন। এর অর্থ kernel-এর out of memory killer process-টি বন্ধ করেছে। 1 GB box-এ GitLab চালানো tuning-এর সমস্যা নয়। এটি চলবে না।

Tier 0: SSH-এর মাধ্যমে bare repository

Git-এর জন্য কোনো network daemon চালু করার প্রয়োজন নেই। git push SSH-এর মাধ্যমে দূরের প্রান্তে সাধারণ Unix process হিসেবে git-receive-pack চালায়, তাই key দিয়ে যে account-এ পৌঁছাতে পারেন, সেটিই ইতিমধ্যে একটি Git remote। Repository-গুলোর জন্য একটি account তৈরি করুন। Repository-গুলো তার home directory-এর বাইরে রাখুন, যাতে পরে যোগ করা web view-এর ওই home directory-তে access না লাগে।

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 ছাড়া একটি repository তৈরি করে। Server-এ এ ধরনের repository-ই রাখা হয়। working copy থাকা repository-এর checked-out branch-এ push করা হলে default হিসেবে refusing to update checked out branch: refs/heads/main-এর কারণে তা প্রত্যাখ্যান করা হয়। এই tier-এ এটিই সবচেয়ে সাধারণ ভুল।

এখন account-টিতে একটি key দিন এবং 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-এর শেষে * [new branch] main -> main দেখা যায়। git@vps.example.com: Permission denied (publickey) দিয়ে শেষ হলে authentication হয়নি। তাই sudo journalctl -u ssh -n 20 দিয়ে server log পড়ুন। Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys লেখা একটি line-এর অর্থ ownership বা file mode ভুল। কারণ untrusted owner থাকা বা অন্য user-কে write করার অনুমতি দেওয়া key file sshd প্রত্যাখ্যান করে।

যদি project-এর origin ইতিমধ্যে GitHub-কে নির্দেশ করে, git remote add origin error: remote origin already exists. দিয়ে থেমে যাবে। ওই remote-এ এই server-কে দ্বিতীয় push URL হিসেবে যোগ করলে একটি git push উভয় স্থানই update করবে।

এরপর account-টির shell সরিয়ে দিন।

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

git-shell শুধু Git SSH-এর মাধ্যমে পাঠানো অল্প কয়েকটি command গ্রহণ করে। তাই interactive login এখন prompt না দেখিয়ে একটি message দিয়ে থেমে যাবে:

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

এটাই সম্পূর্ণ server। কোনো database নেই। Upgrade করার মতো কোনো web process-ও নেই। এর বিনিময়ে forge-এর সব সুবিধা ছাড়তে হবে: browsing নেই, issue tracker নেই, pull request নেই, এবং প্রতি-user permission নেই। ওই file-এর প্রতিটি key git user-এর মালিকানাধীন প্রতিটি repository পড়তে ও লিখতে পারে।

স্তর 1: cgit কোনো database ছাড়াই web view দেয়

cgit হলো C-তে লেখা একটি CGI (common gateway interface) program। Web server প্রতিটি request-এর জন্য এটি একবার চালায়, এটি সরাসরি disk থেকে repository পড়ে এবং নিজস্ব কোনো state সংরক্ষণ করে না। Ubuntu 24.04-এর universe component-এ এটি রয়েছে।

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

/etc/cgitrc-এ repository directory-এর path দিন:

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 ওই directory-টি খুঁজে দেখে সেখানে পাওয়া প্রতিটি repository তালিকাভুক্ত করে। তাই নতুন bare repo অতিরিক্ত configuration ছাড়াই দেখা যায়। cache-size হলো cached page-এর সংখ্যা। এটি zero হলে caching বন্ধ থাকে। নতুন line যোগ করার আগে package ইতিমধ্যে /etc/cgitrc-এ কী লিখেছে তা পড়ুন, কারণ Debian এবং Ubuntu package নিজেদের কিছু default সরবরাহ করে।

প্রতিটি entry repository-এর description file-এর প্রথম line দেখায়। তাই নতুন bare repo নিজেকে Unnamed repository; edit this file 'description' to name the repository. হিসেবে তালিকাভুক্ত করে। প্রতি repository-তে একবার এটি ঠিক করুন:

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
nginx site file এবং এটি কীভাবে পরীক্ষা করবেন
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 এবং cgit.png-কে plain file হিসেবে পরিবেশন করে। আর try_files-এর মাধ্যমে অন্য সব request /usr/lib/cgit/cgit.cgi-এর CGI-তে পাঠানো হয়। /var/log/nginx/error.log-এ connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) সহ 502 page দেখা গেলে socket unit চালু নেই, অথবা এটি অন্য path-এ listen করছে। systemctl show line-টি এটি বাস্তবে যে path ব্যবহার করে তা দেখায়।

এটির ওপর নির্ভর করে configuration তৈরি করার আগে দুটি সীমাবদ্ধতা জানা দরকার। এই configuration-এ cgit read-only এবং এতে login নেই। তাই scan-path-এর অধীনে থাকা সবকিছু public। Private repository ওই directory-এর বাইরে রাখুন, অথবা পুরো site-এর সামনে HTTP basic authentication দিন। CGI web server user হিসেবে চলে। তাই ওই user-এর /srv/git traverse করার এবং প্রতিটি repository পড়ার permission প্রয়োজন। যে directory-তে user ঢুকতে পারে না, সেটি error-এর বদলে empty index হিসেবে দেখা যায়।

Tier 2: issue ও pull request-এর জন্য Forgejo বা Gitea

Forgejo এবং Gitea একই ধারণার উপর তৈরি: একটি Go binary, যা users, organisations, issues, pull requests, releases, একটি package registry এবং একটি built-in CI system-সহ web forge সরবরাহ করে। Binary এবং SQLite-ই সম্পূর্ণ installation, তাই এমন hardware-এও এগুলো চালানো যায় যেখানে GitLab চলবে না। নিচের Compose file-টি Forgejo documentation-এ দেওয়া file, যেখানে 24 October 2026 অনুযায়ী উল্লিখিত image tag ব্যবহার করা হয়েছে।

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'

ওই 17 tag-টি v17 line অনুসরণ করে। 26 October 2026-এ প্রকাশিত Forgejo v17.0.1 বর্তমান stable release, এবং Forgejo v17-এর support 28 January 2027 পর্যন্ত থাকবে। পুরোনো v16 line-এর support 29 October 2026-এ শেষ হবে, তাই 16 tag-এ থাকা existing install এখন upgrade করার সময় হয়েছে। পরে এক major version থেকে পরেরটিতে যেতে manual upgrade প্রয়োজন হবে, তাই শুরুতেই current version ব্যবহার করা বেশি সুবিধাজনক।

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

curl line-এ একটি HTTP status line দেখা উচিত। প্রথমবারের setup শেষ করার আগে এটি /install-এ redirect হতে পারে; তবুও এর অর্থ service চালু আছে। এর পরিবর্তে container exit করলে সাধারণত কারণ ownership: ./forgejo directory-টির মালিকানা USER_UID-এ থাকা UID (user id)-এর হতে হবে, নইলে process নিজের data directory-তে লিখতে পারে না। VPS-এ Docker Compose-এ এই file layout এবং volume ownership rule বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।

Setup page-এর দুটি উত্তর clone URL কাজ করবে কি না তা নির্ধারণ করে। SSH port-টি host side-এর SSH mapping হতে হবে। উপরের Compose file-এ এটি 222, কারণ এটি host port 222-কে container-এর port 22-এ map করে। 222 port ব্যবহার করতেই হবে এমন নয়: যেকোনো free host port ব্যবহার করা যায়, যদি mapping এবং এই উত্তর একে অপরের সঙ্গে মিলে। Domain-টিও এমন নাম হতে হবে যা users বাস্তবে type করবে। যেকোনো একটি ভুল হলে প্রতিটি repository page এমন clone command দেবে, যা কপি করা সবার জন্য ব্যর্থ হবে। পরে এগুলো app.ini-এর [server] section-এ যথাক্রমে SSH_PORT, SSH_DOMAIN এবং ROOT_URL হিসেবে থাকে।

Public instance-এর ক্ষেত্রে web port শুধু loopback address-এ publish করুন ('127.0.0.1:3000:3000') এবং TLS (transport layer security)-এর জন্য এর সামনে nginx ব্যবহার করুন। Gitea তার documentation-এ ব্যবহৃত docker.gitea.com/gitea image থেকে একইভাবে install করা যায়, অথবা একটি systemd unit এবং একটি app.ini-সহ single binary হিসেবে চালানো যায়। এর বর্তমান stable release v28.2.0, যা 18 October 2026-এ প্রকাশিত হয়েছে। September-এর শেষে v28.0.0 প্রকাশের সময় project-টি পুরোনো 1. prefix বাদ দিয়েছে। তাই 1.27-এর পরের release হলো 28, 1.28 নয়।

সম্ভব হলে SQLite ব্যবহার করুন। এতে instance একটি process এবং একটি file-এই সীমাবদ্ধ থাকে, এবং supervise করার জন্য অতিরিক্ত service ছাড়াই reboot-এর পর চালু থাকে। একসঙ্গে অনেকজন লিখলে PostgreSQL ব্যবহার করা যুক্তিযুক্ত, কারণ SQLite write serialise করে এবং দীর্ঘ CI run-এ নিয়মিত write হয়। দুটি project-ই পরে existing instance PostgreSQL-এ স্থানান্তর করতে পারে। তাই এটি এমন সিদ্ধান্ত নয়, যেটিতে পরে আটকে থাকতে হবে।

Forgejo এবং Gitea: বাস্তবে কী কী পার্থক্য

উভয়ের উৎস একই। Gitea 2016 সালে Gogs থেকে fork হয়। 2022 সালের শেষ দিকে Gitea domain এবং trademark-এর নিয়ন্ত্রণ Gitea Ltd নামের একটি কোম্পানির কাছে যায়। এরপর কয়েকজন maintainer এবং Codeberg মিলে Forgejo শুরু করে। Forgejo Codeberg e.V.-এর ছত্রচ্ছায়ায় এর community দ্বারা উন্নত হয়। Codeberg e.V. জার্মানিতে নিবন্ধিত একটি non-profit association, যা প্রকল্পটির domain ধরে রাখে। তবে governance Forgejo-এর নিজস্ব contributor-দের কাছেই থাকে। 2024 সালে এটি MIT licence থেকে GPLv3 (GNU general public license version 3)-এ পরিবর্তিত হয়। Gitea এখনও MIT licensed এবং এর পেছনে commercial backing নিয়ে উন্নত হচ্ছে।

দৈনন্দিন ব্যবহারে feature set দুটির কাছাকাছি। তবে একটির database থেকে অন্যটিতে যাওয়ার পথ সরাসরি নয়। January 2025-এর Forgejo v10.0 ছিল সর্বশেষ release, যা সরাসরি Gitea database নিতে পারত, তাও শুধু Gitea v1.22 বা তার আগের সংস্করণ থেকে। October 2026 অনুযায়ী Gitea v28.2.0-এ আছে। তাই বর্তমান Gitea instance থেকে Forgejo-তে supported in-place switch নেই। এতে data যোগ করার আগে একটি বেছে নিন। পরে স্থানান্তরের প্রয়োজন হলে সেটিকে export এবং re-import হিসেবে পরিকল্পনা করুন।

বেছে নেওয়ার সংক্ষিপ্ত নিয়ম হলো: governance আপনার কাছে গুরুত্বপূর্ণ হলে, অথবা non-profit umbrella-এর অধীনে থাকা project চাইলে, Forgejo চালান। বড় install base এবং commercial support option চাইলে, Gitea চালান। উভয় project-ই open ভাবে maintained হয় এবং নিয়মিত release প্রকাশ করে। Forgejo প্রতি তিন মাসে একটি stable release এবং প্রতি বছর একটি LTS (long term support) release প্রকাশ করে। 29 October 2026 অনুযায়ী v17.0.1 বর্তমান এবং v15.0.11 হলো LTS। Forgejo v17-কে 28 January 2027 পর্যন্ত এবং v15-কে 15 July 2027 পর্যন্ত support করে। v16-এর support 29 October 2026-এ শেষ হয়। তাই কোনো major version pin করার আগে releases page পরীক্ষা করুন।

Tier 3: GitLab কিছু করার আগেই এর খরচ

GitLab CE ভিন্ন ধরনের সফটওয়্যার। একটি instance হলো পরস্পরের সঙ্গে সমন্বয় করে কাজ করা কয়েকটি service-এর সমষ্টি: web application-এর জন্য Puma, background job-এর জন্য Sidekiq, PostgreSQL, Redis, repository access-এর জন্য Gitaly এবং সামনে nginx। Omnibus package এগুলো একসঙ্গে install করে। এতে installation সহজ হয়, কিন্তু memory-এর ন্যূনতম প্রয়োজন অনেক বেড়ে যায়।

GitLab-এর requirements page একটি single-node installation-এর baseline হিসেবে 16 GB RAM এবং 8 vCPU উল্লেখ করে। Memory-constrained environment-এর জন্য সেখানে 8 GB-কে নিম্নসীমা বলা হয়েছে। একই page-এ swap disable করতে বলা হয়েছে, কারণ load-এর সময় swapping হলে instance-এর performance মারাত্মকভাবে কমে যায়। এগুলো October 2026 অনুযায়ী প্রকাশিত figures। বছরের পর বছর এগুলো বেড়েছে। তাই server-এর capacity নির্ধারণের আগে page-টি আবার পড়ুন।

এই budget-এর বিনিময়ে আপনি বাস্তব কিছু সুবিধা পান: container registry, package registry, সূক্ষ্মভাবে নির্ধারণযোগ্য permission এবং বড় scale-এ পরীক্ষিত CI। Compliance center এবং project বা group audit trail ব্যবহারের জন্য paid GitLab tier প্রয়োজন। আপনার team-এর কেউ যদি এই তালিকা থেকে চলতি quarter-এ প্রয়োজনীয় কোনো feature-এর নাম বলতে না পারে, তাহলে বিনিময়ে কিছু না পেয়ে শুধু বড় VPS-এর জন্য অর্থ দিচ্ছেন।

SSH access model: একটি git user এবং অনেক key

System OpenSSH ব্যবহার করলে এখানে প্রতিটি tier একইভাবে authentication করে। git নামে একটি Unix account থাকে, এবং প্রতিটি public key ওই account-এর ~/.ssh/authorized_keys-এ রাখা হয়। Authentication-এর ভিত্তি হলো key। Authorisation নির্ধারিত হয় একই লাইনে key-এর আগে লেখা options দিয়ে।

একটি সাধারণ key line ওই account যা করতে পারে, key-এর ধারককে তার সবকিছুর সুযোগ দেয়। যে account এখনও /bin/bash-কে login shell হিসেবে ব্যবহার করে, তার ক্ষেত্রে forced command দিয়ে কার্যক্রম Git-এ সীমাবদ্ধ করা যায়:

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

OpenSSH 7.2 থেকে পাওয়া restrict port forwarding, agent forwarding, X11 এবং PTY (pseudo terminal) allocation একসঙ্গে বন্ধ করে। command= client যে command চেয়েছিল, তার বদলে আপনার নির্ধারিত command চালায়। SSH server client-এর মূল command $SSH_ORIGINAL_COMMAND-এ রাখে বলে Git তবুও কাজ করে।

একটি forge এই file আপনার হয়ে তৈরি করে। tier 0 এবং tier 2-এর প্রকৃত পার্থক্য এখানেই। Forge-গুলো যখন system OpenSSH server-এর পেছনে চলে, যা তাদের default ব্যবস্থা, তখন Forgejo এবং Gitea authorized_keys-কে rewrite করে। নিবন্ধিত প্রতিটি key-এর জন্য একটি করে line থাকে। প্রতিটি line-এ database id দিয়ে key-টি চিহ্নিত করা forced command থাকে:

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

এই forced command-ই একটি shared Unix account-কে প্রতি-user permission-এ পরিণত করে। key-3 forge-কে জানায় কোন user সংযোগ করছে। কোনো object transfer হওয়ার আগে forge সেই user-কে repository-এর সঙ্গে যাচাই করে। Forge-managed box-এ এই file নিজে সম্পাদনা করবেন না। Database থেকে file-টি আবার লেখা হয়, তাই আপনার line হারিয়ে যাবে। Forge-এর built-in SSH server চালু করলে, অথবা AuthorizedKeysCommand ব্যবহার করে OpenSSH-কে forge থেকে key নিতে বললে, forge-এর এই file প্রয়োজন হয় না। দ্বিতীয় ক্ষেত্রে উভয় project-ই এর creation বন্ধ করতে বলে। Deploy key একই mechanism থেকে আসে। Deploy key হলো একটি সাধারণ SSH key, যা একটি নির্দিষ্ট repository-এর সঙ্গে নিবন্ধিত থাকে। এটি সাধারণত read-only হয়। এই check sshd-এর বদলে forge-এ সম্পন্ন হয়।

উপরের configuration-এর চেয়ে দুটি অভ্যাস বেশি গুরুত্বপূর্ণ। প্রতি ব্যক্তি বা প্রতি machine-এর জন্য একটি করে key ব্যবহার করুন। কখনো shared key ব্যবহার করবেন না। কারণ shared key revoke করতে হলে একসঙ্গে সবার জন্য key rotate করতে হয়। কেউ চলে যাওয়ার দিনই তার key সরিয়ে ফেলুন। ওই file-এ পুরোনো key থাকলে সেটি এমন একটি স্থায়ী login হয়ে থাকে, যা কেউ monitor করছে না। Server-এ ভালো SSH key management-এ key type এবং passphrase নিয়ে আলোচনা করা হয়েছে, এবং সেগুলো এখানে অপরিবর্তিতভাবে প্রযোজ্য। Box-টি নতুন হলে repository রাখার আগে নতুন VPS-এ প্রথম দশ মিনিট অনুসরণ করাই সঠিক পদক্ষেপ।

আমি কি নিজের Git server-এ GitHub Actions চালাতে পারি?

আপনি GitHub Actions syntax-এ লেখা workflow চালাতে পারেন। তবে GitHub চালাতে পারবেন না। Forgejo v1.21 থেকে Forgejo Actions ডিফল্টভাবে enabled থাকে এবং প্রতিটি repository-র .forgejo/workflows থেকে workflow file পড়ে। Gitea Actions একইভাবে কাজ করে এবং .gitea/workflows পড়ে। উভয়ের জন্যই runner নামে একটি দ্বিতীয় program install করতে হবে এবং admin settings-এর token দিয়ে আপনার instance-এর সঙ্গে register করতে হবে। প্রকাশিত অনেক action কোনো পরিবর্তন ছাড়াই চলে।

দুটি বিষয় বিবেচনায় রাখুন। প্রচলিত container label ব্যবহার করলে runner প্রতিটি job-এর জন্য একটি container চালু করে। তাই runner-এর নিজস্ব container engine এবং memory budget দরকার। এই কারণে forge-এর একই 1 GB box-এ runner রাখা উচিত নয়। উভয় runner-ই সরাসরি host-এ job চালাতে পারে। Forgejo-তে এর জন্য :host-এ শেষ হওয়া label ব্যবহার করা হয়। এতে engine লাগে না, কিন্তু job এবং ওই machine-এর মধ্যে কোনো container isolation থাকে না। Workflow file-এ যা বলা থাকে runner তা-ই execute করে। Forgejo-এর documentation-এ বিষয়টি স্পষ্টভাবে বলা হয়েছে: runner remote code execution সম্পাদন করে। সম্ভব হলে runner-এর জন্য আলাদা host ব্যবহার করুন। অন্তত নিজস্ব unprivileged user এবং একটি repository-তে সীমাবদ্ধ registration token ব্যবহার করুন।

আপনার repository যদি GitHub-এই থাকে এবং শুধু আপনার নিয়ন্ত্রণাধীন hardware-এ compute চালাতে চান, সেটি ভিন্ন setup এবং তার ধাপও আলাদা: একটি self-hosted GitHub Actions runner GitHub repository-র সঙ্গে যুক্ত হয় এবং এসব কিছুর কোনোটিই প্রয়োজন হয় না। GitHub ছেড়ে দিলে কী খরচ হবে তা এখনও বিবেচনা করলে, GitHub আসলে আপনাকে কী দেয় Git hosting-কে তার চারপাশের network থেকে আলাদা করে দেখায়।

Backups: repository শুধু state-এর অর্ধেক

একটি bare repository আসলে একটি directory। তাই এটি copy করলে এর ভেতরের সবকিছু copy হয়। অন্য machine থেকে mirror clone একটি প্রকৃত backup, এবং এটি একই জায়গায় refresh করা যায়:

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

এতে প্রতিটি ref এবং প্রতিটি object pull হয়। তবে server-side hook বা description file pull হয় না। তাই hook ব্যবহার করলে directory-টির file-level copy-ও সংরক্ষণ করুন।

একটি forge issues, pull request, user, key এবং permission database-এ সংরক্ষণ করে। শুধু repository-গুলোর copy রাখলে এগুলো সব হারিয়ে যাবে। উভয় project-ই এমন একটি dump command দেয়, যা database, repository, configuration এবং attachment একটি archive-এ লেখে:

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

Docker-এর অধীনে একই command container-এর ভেতরে চালাতে হয়। Configuration path image অনুযায়ী ভিন্ন হয়। তাই command লেখার আগে path পরীক্ষা করুন:

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

Data-এর owner user হিসেবে এটি চালান। Archive এমন একটি directory-তে লিখুন, যেখানে ওই user-এর write permission আছে। এরপর archive-টি server-এর বাইরে copy করুন। যে machine-এর backup নেওয়া হচ্ছে, শুধু সেই machine-এ থাকা backup প্রকৃত backup নয়। Restore হলো যে ধাপটি মানুষ প্রায়ই বাদ দেয়। এখনই একটি spare box-এ একটি dump unpack করে দেখুন। এতে outage চলাকালীন নয়, শান্ত সময়ে procedure শিখে নিতে পারবেন।

পরিস্থিতি অনুযায়ী নির্বাচন

একজন ব্যক্তি, একটি laptop এবং একটি VPS, আর browsing-এর প্রয়োজন নেই: SSH-এর মাধ্যমে bare repository। অতিরিক্ত কোনো service চলছে না এবং upgrade করারও কিছু নেই।

একই পরিস্থিতি, তবে browser-এ code পড়তে এবং code-এর link পাঠাতে চান: cgit যোগ করুন। এখনও কোনো database নেই এবং memory-তে স্থায়ীভাবে চলা কোনো service-ও নেই।

এমন একটি team, যারা একে অপরের code review করে এবং issue track করে: 2 GB RAM বা তার বেশি নিয়ে Forgejo অথবা Gitea ব্যবহার করুন। job বাস্তব workload পেলে CI runner-টি দ্বিতীয় একটি box-এ সরিয়ে নিন।

এমন একটি organisation, যার container registry এবং audit trail প্রয়োজন এবং server-এর জন্য 16 GB RAM বরাদ্দ করা সম্ভব: GitLab ব্যবহার করুন। এই budget-এর নিচে এটি চালু করবেন না।

প্রথম তিনটি tier-এর মধ্যে উপরে ওঠা সস্তা, কারণ এই সব tier-এ repository-গুলো disk-এর সাধারণ Git directory। যে tier আপনার কাজ সম্পন্ন করে, সেখান থেকেই শুরু করুন। একই server-এ আর কী কী service-এর জন্য জায়গা রাখা উচিত তা নির্ধারণ করতে চাইলে, যে service-গুলো self-hosting করার মতো সেই সংক্ষিপ্ত তালিকায় Git server-কে একই RAM-এর জন্য প্রতিদ্বন্দ্বিতা করা অন্যান্য service-এর পাশে রাখা হয়েছে।

FAQ

একটি 1 GB VPS কি Forgejo বা Gitea চালাতে পারে?

হ্যাঁ, ছোট দলের জন্য SQLite ব্যবহার করলে এবং সেই মেশিনে অন্য কোনো ভারী কাজ না চললে পারে। Gitea-এর documentation অনুযায়ী ছোট দল ও project-এর জন্য সাধারণত 1 GB RAM এবং 2 CPU core যথেষ্ট। Forgejo হলো Gitea-এর একটি fork এবং এর resource profile-ও একই রকম। সেই মেশিনে PostgreSQL বা CI runner যোগ করবেন না। service-এর নিজস্ব log-এ কোনো error না থাকলেও যদি সেটি হঠাৎ বন্ধ হয়ে যায়, sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' চালান। নিহত process-এর নামসহ একটি line থাকলে বুঝবেন kernel-এর out of memory killer process-টিকে বন্ধ করেছে। এ ক্ষেত্রে tuning flag নয়, বড় plan নিতে হবে।

Forgejo এবং Gitea-এর মধ্যে পার্থক্য কী?

তাদের codebase-এর ইতিহাস এবং অধিকাংশ feature অভিন্ন। Gitea 2016 সালে Gogs থেকে fork হয়। 2022 সালের শেষ দিকে Gitea trademark-এর নিয়ন্ত্রণ একটি company-এর কাছে যাওয়ার পর Forgejo, Gitea থেকে fork হয়। Forgejo-এর development Codeberg e.V.-এর তত্ত্বাবধানে community পরিচালনা করে। এটি Germany-ভিত্তিক একটি non-profit এবং Forgejo GPLv3 license-এর অধীনে প্রকাশিত হয়। Gitea MIT license-এর অধীনেই থাকে এবং এর commercial backing রয়েছে। ব্যবহারিক পার্থক্যটি migration path-এ। January 2025-এর Forgejo v10.0 ছিল সর্বশেষ release, যা সরাসরি Gitea database গ্রহণ করতে পারত। সেটিও কেবল Gitea v1.22 বা তার আগের version থেকে। তাই বর্তমান Gitea instance-এ supported in-place switch নেই।

আমি কি self-hosted Git server-এ GitHub Actions workflow চালাতে পারি?

Forgejo Actions এবং Gitea Actions উভয়ই GitHub Actions YAML syntax-এ লেখা workflow চালায়। এগুলো .forgejo/workflows এবং .gitea/workflows থেকে পড়ে। আপনাকে একটি পৃথক runner program install করে সেটিকে আপনার instance-এর সঙ্গে register করতে হবে। প্রকাশিত অনেক action কোনো পরিবর্তন ছাড়াই কাজ করে। Runner আপনার repository থেকে arbitrary code execute করে এবং প্রচলিত container label ব্যবহার করলে প্রতিটি job-এর জন্য একটি করে container চালু করে। তাই runner-এর জন্য আলাদা host ব্যবহার করুন। অন্তত একটি পৃথক unprivileged user ব্যবহার করুন। ইতিমধ্যে forge চালু থাকা 1 GB server-এ runner রাখবেন না।

আমি কীভাবে self-hosted Git server-এর backup নেব?

Bare repository-এর ক্ষেত্রে অন্য একটি মেশিন থেকে git clone --mirror চালালে প্রতিটি ref এবং object copy হয়। ওই mirror-এর ভিতরে git remote update চালালে সেটি refresh হয়। Forgejo বা Gitea-এর ক্ষেত্রে repository হলো সম্পূর্ণ state-এর কেবল একটি অংশ। কারণ issue, pull request, user এবং key database-এ থাকে। Built-in dump ব্যবহার করুন: sudo -u git forgejo dump -c /etc/forgejo/app.ini। Docker install হলে container-এর ভিতরেও একই command চালাতে পারেন। Archive-টি server-এর বাইরে copy করুন। এরপর spare machine-এ অন্তত একবার সেটি restore করে দেখুন, যাতে নিশ্চিত হন যে পদ্ধতিটি কাজ করছে।

এই লেখাটি কি কাজে লেগেছে?

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