SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

셀프 호스팅 Git 서버 추천: Forgejo, Gitea, cgit 비교

VPS 사양에 맞는 최적의 Git 서버를 선택하십시오. SSH 베어 리포지토리부터 cgit, Forgejo, Gitea, GitLab까지 RAM 사용량을 기준으로 1GB VPS에서 운영 가능한 서버를 비교하고 각 옵션의 메모리 요구 사항을 정리했습니다.

어떤 셀프 호스팅 Git 서버를 운영해야 하는가

셀프 호스팅 Git 서버는 단일 제품이 아니며, VPS의 RAM(random access memory) 용량에 따라 운영 가능한 버전이 결정됩니다. Git은 자체 데몬이 필요하지 않습니다. 베어 리포지토리와 SSH(secure shell) 계정만 있으면 가장 작은 서버에서도 즉시 작동하는 서버가 됩니다. 그 이상의 모든 것은 함께 실행할 웹 애플리케이션을 선택하는 과정이며, 단계가 올라갈 때마다 작은 VPS가 감당하기 어려운 메모리를 소모합니다. Git과 GitHub의 차이를 아직 명확히 구분하기 어렵다면, Git, GitHub, 그리고 나만의 Git 서버가 어떻게 다른지를 통해 계층을 선택하기 전 그 차이를 먼저 확인하십시오.

네 단계가 있습니다. SSH를 통한 베어 리포지토리는 기존에 실행 중인 서비스 외에 추가로 실행되는 것이 없습니다. cgit은 데이터베이스 없이 빠르게 읽기 전용 웹 뷰를 제공합니다. Forgejo나 Gitea는 계정, 이슈, 풀 리퀘스트 기능을 포함한 완전한 포지(forge)이며 수백 메가바이트의 메모리를 사용합니다. GitLab은 다른 서비스들보다 훨씬 큰 규모의 서버 자원을 요구합니다.

수행해야 할 작업에 따라 결정한 뒤, 현재 사용 중인 요금제의 메모리 사양과 비교하여 확인하십시오.

각 옵션별 실제 RAM 요구량

이 프로젝트들 중 하드웨어 사양을 공개한 곳은 두 곳뿐입니다. 공개된 수치는 보장값이 아니라 최소 사양으로 간주해야 하며, 실제 운영 환경에서는 systemd-cgtop 또는 ps -o rss= -C forgejo를 사용하여 직접 측정해야 합니다.

차트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
  }
]

Gitea는 소규모 팀과 프로젝트에 일반적으로 1 GB의 RAM과 2개의 CPU 코어가 충분하다고 명시하며, 소규모 작업 부하에는 Raspberry Pi 3로도 충분하다고 언급합니다. GitLab은 단일 노드 설치의 기본 사양으로 16 GB를, 자체 문서에서 메모리 제약 환경이라고 부르는 최소 사양으로 8 GB를 제시합니다. Forgejo의 설치 문서에는 RAM 수치가 나와 있지 않습니다. Forgejo는 Gitea의 포크 버전이며 동작 방식도 유사하므로, Gitea의 수치가 가장 근접한 가이드라인이 됩니다.

1 GB VPS 환경에서 이는 무엇을 의미할까요? bare 리포지토리와 cgit은 상주 서비스가 실행되지 않으므로 충분히 여유 있게 구동됩니다. Forgejo나 Gitea는 SQLite를 사용할 경우 시작이 가능하고 소규모 팀을 지원할 수 있지만, 이는 문서화된 최소 사양에 걸쳐 있는 상태이므로 해당 서버에서 PostgreSQL과 CI(지속적 통합) 러너는 제외해야 합니다. 웹 인터페이스가 오류 메시지 없이 사라진다면 sudo dmesg -T | grep -Ei 'oom|out of memory|killed process'을 실행하여 Out of memory: Killed process 1181 (forgejo)과 같은 줄이 있는지 확인하십시오. 이는 커널의 OOM(Out of Memory) 킬러가 해당 프로세스를 종료했음을 의미합니다. 1 GB 서버에서 GitLab을 구동하는 것은 튜닝의 문제가 아닙니다. 애초에 실행 자체가 불가능합니다.

Tier 0: SSH를 통한 베어 리포지토리

Git은 별도로 실행해야 할 네트워크 데몬이 없습니다. SSH를 통한 git push는 원격지에서 일반적인 Unix 프로세스로서 git-receive-pack을 실행하므로, 키를 통해 접근할 수 있는 모든 계정은 이미 Git 리모트가 됩니다. 리포지토리 전용 계정을 하나 만들고, 나중에 웹 뷰어를 추가할 때 홈 디렉터리에 접근할 필요가 없도록 리포지토리를 홈 디렉터리 외부에 배치하십시오.

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는 작업 복사본이 없는 리포지토리를 생성하며, 이는 서버가 유지하는 형태입니다. 작업 복사본이 있는 리포지토리의 체크아웃된 브랜치로 푸시하는 작업은 기본적으로 refusing to update checked out branch: refs/heads/main에 의해 거부되며, 이는 이 단계에서 가장 흔히 발생하는 실수입니다.

이제 해당 계정에 키를 등록하고 리포지토리를 복제하십시오.

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

성공적인 첫 푸시는 * [new branch] main -> main으로 끝납니다. git@vps.example.com: Permission denied (publickey)로 끝나는 경우 인증이 되지 않은 것이므로 sudo journalctl -u ssh -n 20을 사용하여 서버 로그를 확인하십시오. Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys라는 메시지가 포함된 줄이 있다면 소유권이나 파일 모드가 잘못된 것입니다. sshd는 신뢰할 수 없는 소유자나 다른 사용자가 쓰기 권한을 가진 키 파일을 거부하기 때문입니다.

프로젝트의 origin이 이미 GitHub를 가리키고 있다면 git remote add origin은 error: remote origin already exists.와 함께 중단됩니다. 이때 해당 리모트에 이 서버를 두 번째 푸시 URL로 추가하면 git push 한 번으로 두 곳 모두 업데이트할 수 있습니다.

이제 해당 계정의 셸 접근 권한을 회수하십시오.

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

git-shell는 Git이 SSH를 통해 보내는 몇 가지 명령만 허용하므로, 이제 대화형 로그인을 시도하면 프롬프트 대신 메시지가 출력되며 종료됩니다.

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

이것이 서버의 전부입니다. 데이터베이스도 없고 업그레이드할 웹 프로세스도 없습니다. 대신 코드 저장소 서비스(forge)가 제공하는 모든 기능, 즉 브라우징, 이슈 트래커, 풀 리퀘스트, 사용자별 권한 관리는 포기해야 합니다. 해당 파일에 등록된 모든 키는 git 사용자가 소유한 모든 리포지토리를 읽고 쓸 수 있습니다.

Tier 1: cgit은 데이터베이스 없이 웹 뷰를 제공합니다

cgit은 C로 작성된 CGI(common gateway interface) 프로그램입니다. 웹 서버는 요청마다 이 프로그램을 실행하며, 저장소를 디스크에서 직접 읽어오므로 자체적인 상태를 저장하지 않습니다. Ubuntu 24.04의 universe 구성 요소에서 이를 제공합니다.

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

/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은 해당 디렉터리를 탐색하여 발견된 모든 저장소를 나열하므로, 새로운 bare 저장소를 추가해도 별도의 설정 없이 즉시 나타납니다. cache-size은 캐시된 페이지의 개수이며, 이 값이 0이면 캐싱은 비활성화된 상태로 유지됩니다. Debian 및 Ubuntu 패키지에는 자체적인 기본 설정이 포함되어 있으므로, 설정을 추가하기 전에 /etc/cgitrc에 이미 포함된 내용을 먼저 확인하십시오.

각 항목은 저장소의 description 파일 첫 줄을 표시하므로, 새로 생성된 bare 저장소는 Unnamed repository; edit this file 'description' to name the repository.로 표시됩니다. 저장소마다 다음 명령으로 이를 수정하십시오:

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
nginx 사이트 파일 및 확인 방법
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를 일반 파일로 제공하며, try_files는 그 외 모든 요청을 /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 오류 페이지가 나타난다면, 소켓 유닛이 실행 중이지 않거나 다른 경로에서 대기 중임을 의미합니다. systemctl show 줄은 실제로 사용 중인 경로를 출력합니다.

구축하기 전에 알아두어야 할 두 가지 제한 사항이 있습니다. 이 설정에서 cgit은 읽기 전용이며 로그인 기능을 제공하지 않으므로, scan-path 하위의 모든 내용은 공개됩니다. 비공개 저장소는 해당 디렉터리에 두지 않거나, 사이트 전체에 HTTP 기본 인증을 적용하십시오. 또한 CGI는 웹 서버 사용자의 권한으로 실행되므로, 해당 사용자가 /srv/git에 접근하여 각 저장소를 읽을 수 있어야 합니다. 접근할 수 없는 디렉터리는 오류 대신 빈 인덱스로 표시됩니다.

2단계: 이슈 및 풀 리퀘스트를 위한 Forgejo 또는 Gitea

Forgejo와 Gitea는 동일한 개념을 가집니다. 사용자, 조직, 이슈, 풀 리퀘스트, 릴리스, 패키지 레지스트리 및 내장 CI 시스템을 갖춘 웹 포지 서비스를 단일 Go 바이너리로 제공합니다. 바이너리와 SQLite만 있으면 전체 설치가 완료되므로, GitLab을 실행할 수 없는 하드웨어에서도 구동이 가능합니다. 아래의 Compose 파일은 Forgejo 문서에 명시된 내용이며, 2026년 10월 24일 기준의 이미지 태그를 사용합니다.

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 태그는 v17 라인을 따릅니다. 2026년 10월 26일에 릴리스된 Forgejo v17.0.1이 현재 안정 버전이며, Forgejo는 2027년 1월 28일까지 v17을 지원합니다. 이전 v16 라인은 2026년 10월 29일에 지원이 종료되었으므로, 여전히 16 태그를 사용하는 기존 설치 환경은 지금 업그레이드가 필요합니다. 메이저 버전을 다음 버전으로 나중에 업그레이드하는 것은 수동 작업이 필요하므로, 현재 버전에서 시작하는 것이 비용 면에서 유리합니다.

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

curl 라인은 HTTP 상태 라인을 출력해야 합니다. 초기 설정을 마치기 전에는 /install로 리다이렉트될 수 있는데, 이는 서비스가 정상적으로 실행 중임을 의미합니다. 만약 컨테이너가 종료된다면, 일반적인 원인은 소유권 문제입니다. ./forgejo 디렉터리는 USER_UID에 명시된 UID(사용자 ID) 소유여야 하며, 그렇지 않으면 프로세스가 자신의 데이터 디렉터리에 쓰기 작업을 할 수 없습니다. VPS에서의 Docker Compose에서 해당 파일 레이아웃과 볼륨 소유권 규칙을 상세히 다룹니다.

설정 페이지의 두 가지 답변은 클론 URL의 작동 여부를 결정합니다. SSH 포트는 호스트 측의 SSH 매핑 포트여야 하며, 위 Compose 파일에서는 호스트 포트 222를 컨테이너의 포트 22로 매핑하므로 222이 됩니다. 222번 포트 자체를 반드시 사용해야 하는 것은 아니며, 매핑 설정과 이 답변이 일치하기만 한다면 사용 가능한 어떤 호스트 포트든 상관없습니다. 또한 도메인은 사용자가 실제로 입력할 이름이어야 합니다. 이 중 하나라도 잘못 설정되면 모든 저장소 페이지에서 복사한 클론 명령이 실패하게 됩니다. 두 설정 모두 이후 app.ini의 [server] 섹션에 SSH_PORT, SSH_DOMAIN, ROOT_URL으로 저장됩니다.

공개 인스턴스의 경우, 웹 포트를 루프백 주소('127.0.0.1:3000:3000')에만 노출하고 그 앞에 nginx를 두어 TLS(전송 계층 보안)를 처리하십시오. Gitea는 문서에서 사용하는 docker.gitea.com/gitea 이미지를 통해 동일한 방식으로 설치하거나, 하나의 systemd 유닛과 하나의 app.ini을 사용하는 단일 바이너리로 설치할 수 있습니다. 현재 안정 버전은 2026년 11월 15일에 릴리스된 v28.4.0입니다. 9월 말 v28.0.0부터 프로젝트는 기존의 1. 접두사를 삭제했으므로, 1.27 다음 릴리스는 1.28이 아닌 28입니다.

가능한 한 SQLite를 유지하십시오. 인스턴스를 하나의 프로세스와 하나의 파일로 유지할 수 있으며, 별도의 관리 서비스 없이도 재부팅 후 정상적으로 작동합니다. 여러 사용자가 동시에 쓰기 작업을 수행할 때는 PostgreSQL이 비용 효율적입니다. SQLite는 쓰기 작업을 직렬화하는데, 긴 CI 작업은 지속적으로 쓰기를 발생시키기 때문입니다. 두 프로젝트 모두 기존 인스턴스를 나중에 PostgreSQL로 이전할 수 있으므로, 이 결정이 영구적인 것은 아닙니다.

Forgejo 또는 Gitea: 실제 차이점

두 프로젝트는 계보를 공유합니다. Gitea는 2016년 Gogs에서 포크되었습니다. 2022년 말, Gitea 도메인과 상표권에 대한 통제권이 Gitea Ltd라는 기업으로 넘어갔고, 여러 메인테이너가 Codeberg와 함께 Forgejo를 시작했습니다. Forgejo는 프로젝트 도메인을 보유한 독일 등록 비영리 협회인 Codeberg e.V.의 지원 아래 커뮤니티에 의해 개발되며, 거버넌스는 Forgejo 기여자들에게 있습니다. 2024년에는 MIT 라이선스에서 GPLv3(GNU 일반 공중 사용 허가서 버전 3)로 변경되었습니다. Gitea는 MIT 라이선스를 유지하며 상업적 지원을 바탕으로 개발됩니다.

일상적인 기능 세트는 거의 비슷하지만, 두 프로젝트 간의 전환 경로는 그렇지 않습니다. 2025년 1월에 출시된 Forgejo v10.0은 Gitea 데이터베이스를 직접 가져올 수 있는 마지막 릴리스였으며, 그마저도 Gitea v1.22 이하 버전에서만 가능했습니다. 2026년 11월 16일 기준 Gitea는 v28.4.0이므로, 현재 Gitea 인스턴스에서 Forgejo로 지원되는 직접적인 전환 방법은 없습니다. 데이터를 채우기 전에 하나를 선택하고, 나중에 이동해야 한다면 내보내기 및 재가져오기 방식으로 처리하십시오.

선택을 위한 간단한 규칙입니다. 거버넌스가 중요하거나 비영리 단체 산하의 프로젝트를 원한다면 Forgejo를 실행하십시오. 더 큰 설치 기반과 상업적 지원 옵션을 원한다면 Gitea를 선택하십시오. 두 프로젝트 모두 오픈 소스로 유지되며 자주 릴리스됩니다. Forgejo는 3개월마다 안정 버전을, 매년 LTS(장기 지원) 버전을 릴리스하며, 2026년 10월 29일 기준 v17.0.1이 현재 버전이고 v15.0.11이 LTS입니다. Forgejo는 2027년 1월 28일까지 v17을, 2027년 7월 15일까지 v15를 지원합니다. v16 지원은 2026년 10월 29일에 종료되었으므로, 메이저 버전을 고정하기 전에 릴리스 페이지를 확인하십시오. 이 규칙으로 결정하기 어렵다면 Forgejo와 Gitea의 전체 비교를 통해 Actions와 패키지 레지스트리의 차이점을 확인하십시오. 데이터가 쌓여 전환 비용이 커지기 전에 이 세부 사항을 결정해야 합니다.

3단계: GitLab이 아무것도 하기 전에 발생하는 비용

GitLab CE는 다른 범주의 소프트웨어입니다. 인스턴스 하나가 여러 협력 서비스의 집합으로 구성됩니다. 웹 애플리케이션을 위한 Puma, 백그라운드 작업을 위한 Sidekiq, PostgreSQL, Redis, 저장소 접근을 위한 Gitaly, 그리고 앞단에 위치한 nginx가 포함됩니다. Omnibus 패키지는 이들을 한꺼번에 설치하므로 설치는 간편하지만, 최소 메모리 요구 사양은 높습니다.

GitLab의 요구 사항 페이지에는 단일 노드 설치의 기본 사양으로 16 GB RAM과 8 vCPU가 명시되어 있으며, 메모리가 제한된 환경의 하한선으로 8 GB를 언급합니다. 같은 페이지에서 스왑(swap)을 비활성화할 것을 권장하는데, 부하가 걸린 상태에서 스왑이 발생하면 인스턴스 성능이 크게 저하되기 때문입니다. 이는 2026년 10월 기준 공개된 수치이며, 수년에 걸쳐 요구 사양이 상승해 왔으므로 서버 규모를 산정하기 전에 해당 페이지를 다시 확인하십시오.

이 예산을 투자하면 컨테이너 레지스트리, 패키지 레지스트리, 세밀한 권한 관리, 대규모 환경에서 검증된 CI 등 실질적인 기능을 얻을 수 있습니다. 컴플라이언스 센터와 프로젝트 또는 그룹 감사 추적 기능은 유료 GitLab 티어가 필요합니다. 팀원 중 누구도 이번 분기에 필요한 기능으로 위 목록에 있는 것을 언급하지 못한다면, 아무런 이득 없이 더 큰 VPS 비용만 지불하고 있는 셈입니다.

SSH 접근 모델: 하나의 git 계정과 다수의 키

시스템 OpenSSH를 사용하면 모든 계층이 동일한 방식으로 인증합니다. git이라는 하나의 Unix 계정이 존재하며, 모든 공개 키는 해당 계정의 ~/.ssh/authorized_keys 파일에 저장됩니다. 인증은 키를 통해 이루어집니다. 권한 부여는 해당 키와 같은 줄 앞부분에 작성하는 옵션에 따라 결정됩니다.

일반적인 키 항목은 해당 계정이 수행할 수 있는 모든 권한을 키 소유자에게 부여합니다. 여전히 /bin/bash을 로그인 셸로 사용하는 계정의 경우, 강제 명령(forced command)을 사용하여 Git으로만 접근을 제한할 수 있습니다.

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

OpenSSH 7.2부터 도입된 restrict은 포트 포워딩, 에이전트 포워딩, X11 및 PTY(가상 터미널) 할당을 한 단어로 비활성화합니다. command=는 클라이언트가 요청한 명령을 지정한 명령으로 대체하며, SSH 서버가 클라이언트의 원래 명령을 $SSH_ORIGINAL_COMMAND 환경 변수에 저장하므로 Git은 정상적으로 작동합니다.

포지(forge) 소프트웨어는 이 파일을 자동으로 작성하며, 이것이 계층 0과 계층 2의 실질적인 차이점입니다. 기본 설정인 시스템 OpenSSH 서버를 사용하는 경우, Forgejo와 Gitea는 authorized_keys 파일을 다시 작성합니다. 등록된 키마다 한 줄씩 추가하며, 각 줄에는 데이터베이스 ID로 키를 식별하는 강제 명령이 포함됩니다.

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

이 강제 명령을 통해 하나의 공유 Unix 계정이 사용자별 권한을 갖게 됩니다. key-3는 포지에 어떤 사용자가 연결 중인지 알리고, 포지는 객체가 전송되기 전에 해당 사용자가 저장소에 접근할 권한이 있는지 확인합니다. 포지가 관리하는 서버에서 이 파일을 직접 수정하지 마십시오. 데이터베이스에서 파일이 다시 작성되므로 수정 사항이 사라집니다. 포지의 내장 SSH 서버를 활성화하거나 OpenSSH가 AuthorizedKeysCommand을 통해 포지에 키를 요청하도록 설정하면, 포지는 이 파일이 전혀 필요하지 않으며 후자의 경우 두 프로젝트 모두 파일 생성을 비활성화할 것을 권장합니다. 배포 키(deploy key)도 동일한 메커니즘을 사용합니다. 배포 키는 단일 저장소에 등록된 일반적인 SSH 키이며, 일반적으로 읽기 전용으로 설정되고 sshd가 아닌 포지 내부에서 권한 확인이 이루어집니다.

위의 설정보다 두 가지 습관이 더 중요합니다. 사람이나 기기당 하나의 키를 발급하고 공유 키는 절대 사용하지 마십시오. 공유 키를 폐기하려면 모든 사용자에게 키를 동시에 교체해야 하기 때문입니다. 또한 누군가 퇴사하면 즉시 키를 삭제하십시오. 파일에 남아 있는 오래된 키는 아무도 감시하지 않는 영구적인 로그인 수단이 됩니다. 서버에서의 올바른 SSH 키 관리에서 키 유형과 암호(passphrase)에 대해 다루며, 이 내용은 여기에도 그대로 적용됩니다. 서버가 새로 구축된 상태라면 저장소를 올리기 전에 새 VPS에서의 초기 10분 가이드를 따르는 것이 좋습니다.

자체 Git 서버에서 GitHub Actions를 실행할 수 있습니까?

GitHub Actions 문법으로 작성된 워크플로우를 실행할 수 있습니다. GitHub 자체를 실행할 수는 없습니다. Forgejo Actions는 Forgejo v1.21부터 기본적으로 활성화되어 있으며 각 저장소의 .forgejo/workflows에서 워크플로우 파일을 읽습니다. Gitea Actions도 동일한 방식으로 작동하며 .gitea/workflows을 읽습니다. 두 경우 모두 관리자 설정에서 발급받은 토큰으로 인스턴스에 등록된 runner라는 별도의 프로그램이 필요합니다. 공개된 많은 액션은 수정 없이 실행됩니다.

두 가지 결과를 고려해야 합니다. 일반적인 컨테이너 레이블을 사용하면 runner는 모든 작업마다 컨테이너를 시작하므로 자체 컨테이너 엔진과 메모리 예산이 필요합니다. 이것이 바로 forge와 동일한 1 GB 사양의 서버에 runner를 함께 두어서는 안 되는 이유입니다. 두 runner 모두 Forgejo에서 :host로 끝나는 레이블을 통해 호스트에서 직접 작업을 실행할 수 있습니다. 이 방식은 엔진이 필요 없지만 작업과 머신 사이에 컨테이너 격리 계층이 존재하지 않습니다. 또한 runner는 워크플로우 파일에 명시된 모든 명령을 실행하며, Forgejo 문서에도 명시되어 있듯이 runner는 원격 코드 실행(RCE)을 수행합니다. 가능하다면 별도의 호스트를 할당하거나, 최소한 권한이 없는 사용자 계정으로 실행하고 특정 저장소로 범위가 제한된 등록 토큰을 사용하십시오.

저장소는 GitHub에 유지하면서 연산 자원만 직접 제어하는 하드웨어에서 사용하려는 경우, 이는 다른 설정과 단계가 필요한 별개의 작업입니다. 자체 호스팅 GitHub Actions runner는 GitHub 저장소에 연결되며 위에서 언급한 과정이 필요하지 않습니다. 플랫폼 이전에 따른 비용을 고민 중이라면, GitHub이 실제로 제공하는 기능 문서를 통해 Git 호스팅과 그 주변 네트워크 서비스를 구분하여 검토해 보시기 바랍니다.

백업: 저장소는 상태의 절반에 불과합니다

Bare 저장소는 하나의 디렉터리이므로, 이를 복사하면 내부의 모든 항목이 복사됩니다. 다른 머신에서 수행한 mirror clone은 실제 백업이 되며, 제자리에서 갱신할 수 있습니다.

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

이 명령은 모든 ref와 모든 object를 가져옵니다. 하지만 서버 측 hook이나 description 파일은 가져오지 않으므로, hook을 사용한다면 디렉터리 수준의 복사본도 별도로 유지하십시오.

Forge는 이슈, pull request, 사용자, 키, 권한 정보를 데이터베이스에 보관하며, 저장소만 복사해서는 이 모든 정보를 잃게 됩니다. 두 프로젝트 모두 데이터베이스, 저장소, 설정, 첨부 파일을 하나의 아카이브로 묶어주는 dump 명령어를 제공합니다.

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

Docker 환경에서는 동일한 명령을 컨테이너 내부에서 실행하며, 설정 경로는 이미지에 따라 다르므로 명령어를 입력하기 전에 확인하십시오.

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

데이터 소유자 계정으로 명령을 실행하고, 해당 사용자가 쓰기 권한을 가진 디렉터리에 아카이브를 저장하십시오. 그 후 아카이브를 서버 외부로 복사하십시오. 백업 대상 머신에만 존재하는 백업은 진정한 백업이 아니기 때문입니다. 복구는 사람들이 흔히 건너뛰는 단계입니다. 지금 여분의 장비에 덤프 파일을 풀어보십시오. 그래야 장애 상황이 아닌 평온한 시점에 복구 절차를 익힐 수 있습니다.

시나리오별 선택

노트북과 VPS를 사용하는 1인 사용자로 브라우저 확인이 필요 없다면, SSH를 통한 bare repository를 사용하십시오. 추가로 실행되는 서비스가 없으며 업그레이드할 대상도 없습니다.

위와 동일한 환경에서 브라우저로 코드를 읽고 링크를 공유하고 싶다면 cgit을 추가하십시오. 여전히 데이터베이스는 필요 없으며 상주하는 프로세스도 없습니다.

서로의 코드를 검토하고 이슈를 추적해야 하는 팀이라면 2 GB 이상의 RAM을 갖춘 환경에서 Forgejo 또는 Gitea를 사용하십시오. 작업이 본격화되면 CI runner를 두 번째 서버로 옮기십시오.

컨테이너 레지스트리와 감사 추적 기능이 필요한 조직이며 서버에 16 GB RAM을 할당할 수 있다면 GitLab을 사용하십시오. 이 사양 미만이라면 설치를 시작하지 마십시오.

앞선 세 단계는 모두 저장소가 디스크상의 일반적인 Git 디렉터리이므로 상위 단계로 이동하는 비용이 저렴합니다. 업무에 필요한 가장 낮은 단계에서 시작하십시오. 같은 서버에 무엇을 더 올릴지 고민 중이라면, 직접 호스팅할 가치가 있는 서비스 목록에서 RAM을 두고 Git 서버와 경쟁할 다른 서비스들을 확인해 보십시오.

FAQ

1 GB VPS에서 Forgejo나 Gitea를 실행할 수 있습니까?

네, 소규모 팀이 SQLite를 사용하고 서버에 다른 무거운 서비스가 없다면 가능합니다. Gitea 문서에서는 소규모 팀과 프로젝트에 1 GB RAM과 2 CPU 코어가 일반적으로 충분하다고 명시하며, Forgejo는 Gitea에서 파생된 프로젝트로 유사한 특성을 가집니다. 해당 서버에 PostgreSQL이나 CI runner를 추가하지 마십시오. 서비스 자체 로그에 오류 없이 프로세스가 사라진다면 sudo dmesg -T | grep -Ei 'oom|out of memory|killed process'을 실행하십시오. 출력 결과에 해당 프로세스를 지목하는 줄이 있다면 커널의 OOM(Out of Memory) 킬러가 프로세스를 종료한 것이며, 이 경우 튜닝 플래그보다는 더 높은 사양의 플랜을 선택해야 합니다.

Forgejo와 Gitea의 차이점은 무엇입니까?

두 프로젝트는 코드베이스의 역사와 대부분의 기능을 공유합니다. Gitea는 2016년 Gogs에서 파생되었고, Forgejo는 2022년 말 Gitea 상표권에 대한 통제권이 기업으로 넘어간 이후 Gitea에서 파생되었습니다. Forgejo는 독일의 비영리 단체인 Codeberg e.V. 산하 커뮤니티에 의해 개발되며 GPLv3 라이선스로 배포됩니다. 반면 Gitea는 상업적 지원을 받으며 MIT 라이선스를 유지합니다. 실질적인 차이는 마이그레이션 경로에 있습니다. 2025년 1월에 출시된 Forgejo v10.0은 Gitea 데이터베이스를 직접 가져올 수 있는 마지막 릴리스였으며, 이마저도 Gitea v1.22 이하 버전에서만 가능했습니다. 따라서 현재 운영 중인 최신 Gitea 인스턴스를 Forgejo로 전환하는 공식적인 in-place 방식은 없습니다.

자체 호스팅 Git 서버에서 GitHub Actions 워크플로우를 실행할 수 있습니까?

Forgejo Actions와 Gitea Actions 모두 GitHub Actions YAML 문법으로 작성된 워크플로우를 실행하며, .forgejo/workflows 및 .gitea/workflows 디렉터리에서 이를 읽어옵니다. 별도의 runner 프로그램을 설치하고 인스턴스에 등록해야 합니다. 공개된 많은 action이 수정 없이 작동합니다. runner는 저장소의 임의 코드를 실행하며, 일반적인 컨테이너 레이블을 사용할 경우 작업마다 컨테이너를 하나씩 시작합니다. 따라서 runner를 위한 별도의 호스트를 마련하거나 최소한 권한이 없는 별도의 사용자를 할당하고, 이미 Git 서버가 실행 중인 1 GB 서버에서는 분리하는 것이 좋습니다.

자체 호스팅 Git 서버는 어떻게 백업합니까?

Bare 저장소의 경우, 다른 머신에서 git clone --mirror을 사용하면 모든 참조와 객체를 복사할 수 있으며, 해당 미러 내부에서 git remote update를 실행하면 내용을 갱신할 수 있습니다. Forgejo나 Gitea의 경우, 이슈, 풀 리퀘스트, 사용자, 키 정보가 데이터베이스에 저장되므로 저장소만으로는 전체 상태를 백업할 수 없습니다. 내장된 덤프 도구인 sudo -u git forgejo dump -c /etc/forgejo/app.ini을 사용하거나, Docker 설치 환경이라면 컨테이너 내부에서 동일한 명령을 사용하십시오. 생성된 아카이브를 서버 외부로 복사하고, 예비 머신에 한 번 복원해 봄으로써 절차가 정상적으로 작동하는지 확인하십시오.

이 글이 도움이 되었나요?

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