보통 GitHub나 GitLab을 사용하지만,
개인 프로젝트나 내부 네트워크에서만 사용하는 저장소를 운영할 때는
직접 Git 원격 저장소(Remote Repository)를 만드는 것이 훨씬 효율적일 때가 있습니다.
이번 글에서는 Ubuntu 환경에서 Git 원격 저장소를 직접 만드는 방법을 단계별로 설명드리겠습니다.
1. Git 설치 확인
먼저 Git이 설치되어 있는지 확인합니다.
git --version
Bash
복사
만약 설치되어 있지 않다면 아래 명령으로 설치해 주세요.
sudo apt update
sudo apt install git -y
Bash
복사
2. 원격 저장소용 디렉토리 생성
이제 원격 저장소를 저장할 디렉토리를 만들어 줍니다.
예를 들어 /path/test.git 디렉토리를 원격 저장소로 사용하겠습니다.
mkdir /path/test.git
Bash
복사
이 경로는 /home/git/test.git 이나 /srv/git/test.git 처럼
관리용 계정(git 사용자)을 위한 별도 경로로 지정하는 것이 일반적입니다.
3. 디렉토리로 이동 후 Bare 저장소 생성
방금 만든 디렉토리로 이동합니다.
cd /path/test.git
Bash
복사
이제 Git 저장소를 초기화합니다.
여기서 중요한 점은 --bare 옵션을 붙여야 한다는 것입니다.
git init --bare
Bash
복사
--bare 옵션은 작업 디렉토리(working directory)가 없는,순수하게 Git 데이터만 관리하는 저장소를 만드는 옵션입니다.
원격 저장소로 사용할 때는 항상 bare 저장소로 만들어야 합니다.
4. 로컬 저장소에서 원격 저장소 연결
이제 로컬 프로젝트에서 방금 만든 원격 저장소를 연결해 보겠습니다.
cd ~/myproject
git remote add origin user@server_ip:/path/test.git
Bash
복사
•
user → 서버의 사용자 이름
•
server_ip → 서버의 IP 주소 (예: 192.168.0.10)
•
/path/test.git → 아까 생성한 원격 저장소 경로
SSH 접근이 가능한 환경이라면 위 명령으로 연결할 수 있습니다.
5. 원격 저장소에 코드 푸시하기
처음으로 코드를 업로드할 때는 아래처럼 입력합니다.
git push origin master
Bash
복사
혹은 최근 Git에서는 기본 브랜치 이름이 main인 경우가 많습니다.
git push origin main
Bash
복사
정상적으로 연결되면 원격 서버의 /path/test.git 폴더에
Git 객체 데이터가 올라가게 됩니다.
(선택) 전용 Git 계정 생성하기
여러 명이 접근할 예정이라면,
별도의 git 계정을 만들어 SSH를 통해 접근하도록 구성할 수도 있습니다.
sudo adduser git
sudo mkdir -p /home/git/repositories
sudo chown -R git:git /home/git/repositories
Bash
복사
이후 각 사용자의 SSH 공개키(~/.ssh/id_rsa.pub)를
/home/git/.ssh/authorized_keys에 등록해주면 됩니다.
이렇게 하면, GitHub처럼 자체 Git 서버를 운영할 수 있습니다.
마무리
이제 여러분은 직접 Git 원격 저장소를 생성하고 운영할 수 있게 되었습니다.
이 방식은 다음과 같은 상황에서 특히 유용합니다.
•
회사 내부망에서만 사용하는 비공개 저장소
•
인터넷 연결이 어려운 서버 간 코드 동기화
•
GitHub/GitLab 대신 가벼운 자체 Git 서버를 사용하고 싶은 경우
한 줄 요약
“Ubuntu에서 Git 원격 저장소를 직접 만들 때는 git init --bare로 시작하자!”