GitHub를 떠나 Forgejo로 이동하기 — 개발자가 알아야 할 핵심 정리

GitHub를 떠나 Forgejo로 이동하기 — 개발자가 알아야 할 핵심 정리

오픈소스 개발자들 사이에서 Microsoft가 소유한 GitHub를 떠나려는 움직임이 빠르게 커지고 있다. 이를 대신할 선택지로 커뮤니티가 운영하는 자체 호스팅 플랫폼 Forgejo가 주목받고 있다. 2022년 Gitea에서 포크되어 전 세계 개발자들의 관심을 받고 있으며, 2026년 현재 네덜란드 정부가 공식 도입을 발표하며 화제다.

Forgejo란?

Forgejo는 Gitea에서 포크한 오픈소스 코드 호스팅 플랫폼이다. GitHub와 비슷한 화면 구성을 기본으로 하며, 저장소와 컴퓨팅 자원의 소유권을 개발자에게 돌려주는 것을 목표로 하고 있다.

주요 특징은 다음과 같다:

• 커뮤니티 운영: 기업이 아닌 커뮤니티가 직접 관리한다

• 완전한 오픈소스: AGPL-3.0 라이선스로 모든 코드가 공개되어 있다

• 가벼운 설계: 최소 요구사항이 낮아 작은 서버에서도 원활히 동작한다

• GitHub와 비슷한 화면: 인터페이스가 GitHub과 유사하여 이전 시 적응이 빠르다

설치 방법

Docker를활용한간단한 설치부터 소개하겠다.

# Docker Compose로 Forgejo 설치mkdir forgejo && cd forgejocurl -L https://codeberg.org/forgejo/forgejo/releases/download/1.21/forgejo-1.21.7-linux-amd64.xz -o forgejo.xzdocker pull codeberg.org/forgejo/forgejo:1.21

설정 파일 docker-compose.yml을 만든다:

version: "3.8"services:forgejo:image: codeberg.org/forgejo/forgejo:1.21container_name: forgejorestart: unless-stoppedports:- "3000:3000"- "2222:22"volumes:- ./data:/data- /etc/timezone:/etc/timezone:ro- /etc/localtime:/etc/localtime:roenvironment:- USER_UID=1000- USER_GID=1000

서비스를 시작하려면 다음 명령어를 실행한다:

docker-compose up -d

첫 방문은 http://localhost:3000 에서 초기 설정 마법사가 시작된다.

GitHub에서의 이전

마이그레이션 도구로 github2forgejo 스크립트를활용할 수 있다. PatNei와 RGBCube의 GitHub 저장소에서 구할 수 있다.

# 마이그레이션 스크립트 복제git clone https://github.com/PatNei/github2forgejo.gitcd github2forgejo# 환경 변수 설정export SOURCE_TOKEN="your_github_personal_token"export TARGET_TOKEN="your_forgejo_token"export SOURCE_ORG="your_github_org"export TARGET_ORG="your_forgejo_org"

이 도구로 이전할 수 있는 자원은 다음과 같다:

• 저장소 전체

• 이슈와 댓글

• 풀 리퀘스트

• 라벨과 마일스톤

• 릴리스와 위키

지속적 미러링도 설정 가능하여 두 플랫폼을 실시간 동기화 상태로 유지할 수 있다.

네덜란드 정부의 도입

2026년, 네덜란드 정부가 code.overheid.nl에 Forgejo 기반 플랫폼을본격적으로 시작했어요했다. 디지털 주권 확보와 공급망 무결성 강화를 주요 목적으로 꼽았다. 기존의 GitHub나 GitLab에 대한 의존도를 구조적으로 낮추겠다는 취지다.

이 플랫폼은 현재 시범 운영 단계이며, 정부 기관들이이미 가입을 시작하고 있다. 공공부문 오픈소스 소프트웨어를 게시하는 공식 창구로 자리매김하며, GitHub에 대응하는 주권적 대안으로 주목받고 있다.

Forgejo Actions

CI/CD 기능으로 Forgejo Actions를활용할 수 있다. GitHub Actions와 비슷한 문법을 채택하여 워크플로우 파일을 작성한다.

# .forgejo/workflows/example.ymlname: Example Workflowon: [push, pull_request]jobs:build:runs-on: ubuntu-lateststeps:- uses: actions/checkout@v4- name: Setup Gouses: actions/setup-go@v5with:go-version: '1.22'- name: Buildrun: go build ./...

주목할 점으로, Forgejo Actions는 GitHub Actions와의완전한 호환을 지향하는 것은 아니며, 익숙한 사용감 확보에중요한 점을 두고 있다. 그러나 기본적인 CI/CD 파이프라인이라면 문제없이 동작한다.

다른 대안 플랫폼과의 비교

항목	Forgejo	GitLab	Gitea
라이선스	AGPL-3.0	MIT	MIT
커뮤니티 관리	해당	미해당	해당
가벼운 설계	우수	보통	우수
Actions 지원	해당	해당	미해당
Packages 지원	해당	해당	미해당
최소 RAM 요구사항	1GB	4GB	512MB

Forgejo의 핵심 장점은 커뮤니티 운영이라는 점이다. Gitea에서 포크된 이유도 상업적 방향에 대한 커뮤니티의 우려가 반영된 결과다. 기업이 아닌 커뮤니티가 관리함으로써 장기적인 지속 가능성이 보장된다.

정리: Forgejo가적인 개발자

Forgejo는 다음과 같은 개발자에게 추천한다:

• 데이터 주권을 중시하는 개발자: 자신의 코딩 자산의 소유권을 되돌려받고 싶다

• 소규모 팀과 개인 개발자: 가볍고 비용 효율적인 솔루션을 원한다

• 커뮤니티 중심 프로젝트: 특정 기업의 서비스에종속되기 싫다

• 자체 호스팅을 원하는 사람: 클라우드 플랫폼의 제약에서 벗어나 자유로운 환경이 필요하다

반면, GitHub의 Codespaces, Copilot, Workspace, Advanced Security 등 프리미엄 기능에크게의존하는 팀이라면 이전 비용 대비 효과적인 측면이 약할 수 있다.

Forgejo 도입을 검토한다면 먼저 개인 프로젝트나 소규모 팀 환경에서시험삼아 해보는 것을 권장한다. Docker 기반의 간편한 설치와 GitHub와 비슷한 인터페이스로 인해 적응 시간은 짧다. github2forgejo 스크립트로 저장소를 이전하면 기존 워크플로우를크지 않은 변화 없이잠김 없이 이전할 수 있다.

오픈소스의 미래는 커뮤니티의 손에 있다. Forgejo는 그 가능성을 한 발짝 앞서 이끄는 플랫폼이다.

---

관련 링크

• Forgejo 공식 사이트: https://forgejo.org/

• github2forgejo 마이그레이션 스크립트: https://github.com/PatNei/github2forgejo

• 네덜란드 정부 코드 플랫폼: https://code.overheid.nl/

---

📚 출처

• https://news.hada.io/topic?id=29485