Github 원격 저장소 오류 'remote origin already exists' 해결하는 두 가지 방법
Github을 쓰다 보면 한 번쯤 만나게 되는 에러가 remote origin already exists입니다. 이 오류는 이미 원격 저장소가 연결된 상태에서 새로운 저장소를 추가하려고 할 때 발생합니다.
결론부터 말씀드리면, 기존 연결을 끊고 다시 연결하면 해결됩니다. git remote remove origin 명령어로 연결을 제거한 후, git remote add origin [새 주소]로 다시 연결하면 됩니다.
원격 저장소 연결 충돌, 왜 생길까
Github에서 프로젝트를 관리하다 보면 저장소 주소를 변경하거나, 실수로 다른 저장소를 연결한 경우가 생깁니다. 이때 git remote add origin 명령어로 새로운 원격 저장소를 추가하려고 하면 "remote origin already exists"라는 메시지가 뜹니다.
origin이라는 이름의 원격 저장소가 이미 등록되어 있기 때문입니다. 이 상태에서 그냥 push를 시도하면 기존에 연결된 저장소로 코드가 올라갑니다.
의도치 않은 저장소에 소스코드가 푸시될 수 있으니, 반드시 연결을 정리한 후 작업해야 합니다.
오류 해결을 위한 두 가지 방법
방법 1: 기존 연결을 제거하고 새로 연결하기
가장 많이 사용하는 방법입니다. 순서대로 따라 하면 됩니다.
- 기존 원격 저장소 연결 제거
git remote remove origin
이 명령어를 실행하면 origin이라는 이름으로 등록된 원격 저장소 연결이 완전히 사라집니다.
- 새로운 원격 저장소 연결
git remote add origin https://github.com/사용자명/새저장소.git
Github에서 복사한 저장소 주소를 붙여 넣으면 됩니다.
- 연결 확인 후 푸시
git remote -v
origin에 새 주소가 제대로 등록되었는지 확인한 다음, git push origin master 또는 git push origin main 명령어로 코드를 올리면 됩니다.
방법 2: origin 이름 대신 다른 이름 사용하기
기존 연결을 유지하면서 새 저장소를 추가하려면 origin이 아닌 다른 이름을 사용할 수 있습니다.
git remote add new-origin https://github.com/사용자명/다른저장소.git
이렇게 하면 origin과 new-origin 두 개의 원격 저장소를 동시에 관리할 수 있습니다. 다만 push할 때마다 저장소 이름을 정확히 지정해야 하므로, 일반적으로는 첫 번째 방법을 권장합니다.
자주 묻는 질문
Q. git remote remove origin 명령어가 작동하지 않아요
오타가 없는지 다시 확인해보세요. git remote는 띄어쓰기까지 정확해야 합니다.
만약 git remote -v로 확인했을 때 origin이 보이지 않는다면 이미 제거된 상태입니다.
Q. master 대신 main 브랜치를 써야 하나요
Github의 기본 브랜치 이름이 main으로 변경되었습니다. git push origin master가 안 된다면 git push origin main을 시도해보세요.
로컬 브랜치 이름과 원격 브랜치 이름이 일치해야 합니다.
Q. 연결을 제거했는데도 같은 에러가 계속 떠요
터미널을 새로 열거나, 현재 디렉터리가 올바른 프로젝트 폴더인지 확인해보세요. 다른 폴더에서 명령어를 실행하고 있을 가능성이 있습니다.
이 오류는 초보자부터 숙련자까지 누구나 겪을 수 있는 흔한 상황입니다. 복잡하게 생각할 필요 없이 연결을 끊고 다시 연결하는 과정만 기억하면 됩니다.
Github 사용이 익숙해질수록 이런 오류 메시지도 자연스럽게 해결할 수 있을 거예요.
댓글
댓글 쓰기