Supabase 프로젝트 복사하기 (Restore to a New Project)

Supabase는 기존 프로젝트를 새 프로젝트로 복원하는 Restore to a New Project 기능을 제공합니다. 스테이징 환경 구성, 안전한 테스트, 특정 시점 데이터 복구 등에 유용합니다.

요구 사항

• 유료 플랜 (Pro 이상) 필수
• 소스 프로젝트에 Physical Backups 활성화 필요
• PITR(Point-in-Time Recovery) 사용 시 해당 애드온 추가 필요

사용 방법

1. Supabase 대시보드에서 소스 프로젝트로 이동합니다.
2. 좌측 메뉴에서 Database → Backups 로 이동합니다.
3. Restore to a New Project 탭을 선택합니다.
4. 복원할 백업을 선택합니다.
   • PITR 활성화 프로젝트라면 날짜/시간 셀렉터로 특정 시점 지정 가능합니다.
5. Restore 버튼을 클릭합니다.

복원이 완료되면 대시보드에 새 프로젝트가 생성됩니다.

자동으로 복사되는 항목

백업에서 새 프로젝트를 생성할 때 아래 설정이 소스 프로젝트에서 자동으로 이어받습니다.

항목	설명
컴퓨트 인스턴스 크기	소스와 동일한 인스턴스 사이즈
디스크 속성	디스크 크기 및 타입
SSL 설정	SSL enforcement 여부
네트워크 제한	Network restrictions 설정
데이터 및 스키마	모든 테이블, 스키마, 데이터 포함

주의 사항

• 복원으로 생성된 새 프로젝트는 다시 소스로 사용해 추가 복사 불가합니다.
• 데이터베이스 내용만 복사되므로 Edge Functions, Auth 설정, Storage 버킷 정책 등은 별도로 재설정이 필요합니다.
• API 키(anon key, service_role key)는 새 프로젝트에서 새로 발급됩니다.

활용 사례

• 스테이징 환경 분리: 프로덕션 DB를 그대로 복사해 안전하게 테스트
• 특정 시점 데이터 조회: PITR로 특정 시간대 데이터 스냅샷 분석
• 재해 복구 드릴: 백업 복원 절차 검증

---

Restore to a New Project - Supabase Docs