깃허브에 올린 저장소를 삭제하고 싶은데 삭제 버튼이 어디 있는지 모르겠거나, 삭제하면 진짜 복구가 안 되는 건지 걱정되는 분들 많습니다. 실수로 올린 코드, 더 이상 안 쓰는 프로젝트, 테스트용 저장소를 정리하고 싶을 때 — 이 글 보고 따라하세요.
삭제 전에 확인하세요
깃허브 저장소 삭제는 되돌릴 수 없습니다. 삭제하기 전에 아래를 확인하세요:
- 정말 삭제해야 하나요? — Public이 싫은 거면 Private으로 전환하면 됩니다 (아래 대안 참조)
- Fork가 있나요? — 다른 사람이 Fork한 저장소는 원본을 삭제해도 남아 있습니다. 그 Fork에 민감한 정보가 있을 수 있어요
- GitHub Pages를 쓰고 있나요? — 저장소 삭제 시 호스팅되던 사이트도 함께 사라집니다
- GitHub Actions가 연결돼 있나요? — 다른 저장소의 워크플로우에서 참조하고 있으면 오류 발생
- 로컬 백업은? — 코드가 필요할 수 있으면 삭제 전에
git clone으로 내 PC에 복사해두세요
삭제 방법 — 단계별
1단계: 저장소 Settings 진입
- 삭제할 저장소 페이지로 이동
- 상단 탭에서 “Settings” 클릭 (가장 오른쪽. 안 보이면 “…” 메뉴 안에 있을 수 있음)
주의: Settings가 안 보이면 저장소 소유자가 아닌 겁니다. 소유자(Owner)만 삭제할 수 있어요.
2단계: Danger Zone 찾기
- Settings 페이지를 맨 아래로 스크롤
- 빨간 테두리의 “Danger Zone” 섹션이 보임
- “Delete this repository” 버튼 클릭
3단계: 삭제 확인
- 경고 팝업이 뜸: “This action cannot be undone” (되돌릴 수 없음)
- 저장소 이름을 정확히 입력 —
사용자명/저장소명형식으로 타이핑 (복붙 안 됨, 직접 입력해야 함) - “I understand the consequences, delete this repository” 버튼 클릭
- 비밀번호 또는 2FA 인증 요구 → 입력
삭제 완료. 저장소 URL에 접속하면 404 페이지가 나옵니다.
삭제 후 복구할 수 있나요?
일반적으로는 불가능합니다. 하지만 예외가 있어요:
| 상황 | 복구 가능? | 방법 |
|---|---|---|
| 삭제 직후 (90일 이내) | 가능할 수 있음 | GitHub Support에 복구 요청. 보장은 안 됨 |
| Fork가 존재 | 코드는 남아 있음 | Fork를 Clone해서 새 저장소로 재생성 |
| 로컬에 Clone이 있음 | 코드는 있음 | 새 저장소 만들고 Push |
| 90일 이후 + Fork 없음 + 로컬 없음 | 불가능 | 완전 삭제됨 |
GitHub Support 복구 요청: github.com/support에서 “Account recovery” → “Restore a deleted repository” 선택. 삭제 후 90일 이내, 같은 이름으로 새 저장소를 만들지 않았을 때만 가능합니다.
삭제 대신 — 이런 방법도 있습니다
대안 1: Private으로 전환
Public으로 올린 게 부끄럽거나 민감하다면 삭제 대신 Private으로 바꾸면 됩니다.
- Settings → General → Danger Zone
- “Change visibility” → “Make private” 선택
- 확인 → 이제 본인과 초대한 사람만 볼 수 있음
기존 Fork, Star, Watch는 유지되지만 Fork한 사람은 더 이상 원본에 접근 못 합니다.
대안 2: Archive(보관) 처리
프로젝트가 끝났지만 기록은 남기고 싶다면:
- Settings → General → Danger Zone
- “Archive this repository” 클릭
- 저장소가 읽기 전용이 됨 — 코드 열람은 가능하지만 수정·이슈·PR 불가
포트폴리오용으로 “이전에 이런 프로젝트를 했다”는 기록을 남기기에 적합합니다.
대안 3: 민감한 파일만 삭제
저장소 전체가 아니라 특정 파일(비밀번호, API 키 등)만 지우고 싶다면:
- GitHub 웹에서 파일 선택 → 삭제(🗑) → 커밋
- 주의: Git 히스토리에는 이전 버전이 남아 있어서, 히스토리에서도 완전히 제거하려면
git filter-branch또는 BFG Repo-Cleaner 사용이 필요합니다
여러 저장소 한꺼번에 정리하기
테스트용 저장소가 수십 개 쌓였다면, 하나씩 삭제하는 게 번거롭습니다.
- GitHub CLI 사용: 터미널에서
gh repo delete 사용자명/저장소명 --yes로 빠르게 삭제 가능 - 일괄 삭제 스크립트는 주의: 실수로 중요한 저장소를 삭제할 수 있으므로, 목록을 먼저 확인하고 하나씩 실행 권장
정리
- 삭제: Settings → 맨 아래 Danger Zone → “Delete this repository”
- 저장소명 직접 입력 + 비밀번호/2FA 인증 필요
- 삭제 후 90일 이내면 GitHub Support에 복구 요청 가능 (보장 안 됨)
- 삭제 대신 Private 전환, Archive, 파일 단위 삭제도 고려
- 삭제 전에 로컬 Clone으로 백업해두는 것을 권장
이 글은 2026년 7월 기준으로 작성되었습니다.
같은 주제 글 보기