Windows에서 Supabase CLI를 가장 쉽게 설치 · 실행 · 사용 · 제거하는 키트입니다. 명령어를 몰라도 됩니다. 한국어 메뉴에서 번호만 누르면 됩니다.
Supabase(수파베이스)가 뭔가요? — 웹사이트·앱에 필요한 데이터베이스(자료 보관함), 로그인 기능, 파일 저장소를 인터넷에서 한 번에 빌려주는 서비스입니다. CLI는 그 서비스를 내 컴퓨터에서 다루는 작은 명령 프로그램이고, 이 키트는 그 어려운 명령을 대신 눌러주는 한국어 번호 메뉴입니다.
✅ 관리자 권한이 필요 없습니다(안전). 설치는 내 사용자 폴더에만 이뤄지고, "관리자 권한을 허용하시겠습니까?" 창이 뜨지 않습니다.
- 사전 준비물 (시작 전에 필요한 것)
- 필요 프로그램 (대부분 자동 설치)
- 다운로드 · 폴더 두는 법
- 빠른 시작 (딱 3단계)
- 메뉴 한눈에 보기 (실행·사용·작동)
- 전체 워크플로우(작업 순서)
- 메뉴별 실제 실행 명령어
- 문제 · 오류 대처
- 제거 방법
- 안전 주의 (되돌릴 수 없는 작업)
- 파일 · 문서 위치
- 라이선스 · 저작권 · 상업적 사용
📄 더 쉬운 그림식 단계별 설명서는
왕초보가이드.md를 보세요. 🇬🇧 English:README.en.md(전체) ·GUIDE.en.md(왕초보 가이드).
| 준비물 | 꼭 필요? | 설명 |
|---|---|---|
| Windows 10 또는 11 | 필수 | 이 키트는 Windows 전용입니다. |
| 인터넷 연결 | 필수 | 설치 파일과 Supabase 서버에 연결합니다. |
| Supabase 무료 계정 + 프로젝트 | 인터넷 프로젝트를 쓸 때 필수 | 아래 가입 절차 참고 (1분, 카드 없음). |
| Docker Desktop | 선택 | 내 컴퓨터에서 로컬로 미리보기(메뉴 5) 할 때만 필요. 인터넷 프로젝트만 쓰면 없어도 됩니다. |
- 인터넷 브라우저로 supabase.com 접속 → Start your project / Sign up (구글·깃허브 계정으로도 가입 가능)
- New Project(새 프로젝트)를 눌러 프로젝트 1개 만들기 (이름·비밀번호 입력, 지역은 가까운 곳)
- 만든 프로젝트의 Project ID(= Reference ID) 위치 기억하기:
Settings(톱니바퀴) → General → Reference ID (영어+숫자 짧은 글자, 나중에 메뉴
4에서 사용)
무료 플랜으로 충분합니다. 다만 무료 한도(데이터베이스 약 500MB 등)가 있고, 넘으면 멈추거나 유료로 올려야 할 수 있습니다.
메뉴 1(처음 설정)을 누르면 아래가 자동으로, 관리자 권한 없이 순서대로 설치됩니다.
직접 깔 필요가 없습니다.
| 프로그램 | 역할 | 설치 방법 |
|---|---|---|
| Scoop | Windows용 안전한 프로그램 설치 도우미 (사용자 폴더에만 설치) | 메뉴 1이 자동 설치 |
| Git | Scoop이 Supabase를 받아올 때 사용 | 메뉴 1이 자동 설치 |
| Supabase CLI | 핵심 도구 | 메뉴 1이 자동 설치 (scoop install supabase) |
| Docker Desktop | (선택) 로컬 개발용 | 직접 설치: https://www.docker.com/products/docker-desktop/ |
Node.js는 필요 없습니다. 이 키트는 Scoop 방식으로 설치하므로 Node.js가 없어도 됩니다. (정 안 되면
npx supabase라는 폴백 방법도 안내합니다.)
- 이 키트 폴더를 받으면(압축 파일이면 압축을 풀고), 폴더를 통째로 원하는 위치에 둡니다.
(예:
바탕화면또는문서폴더) - 폴더 안에 여러 파일이 함께 있어야 정상 동작합니다.
시작하기.bat만 따로 빼지 마세요. - 인터넷에서 받은 파일은 Windows가 "차단" 표시를 붙일 수 있는데, 이 키트는 실행 시 자동으로 차단을 해제합니다. 그래도 파란 경고가 뜨면 8번 문제 대처를 보세요.
시작하기.bat파일을 더블클릭합니다.- 화면이 "추천: N" 이라고 알려주는 번호를 누릅니다. (보통
1설치 →2로그인) - 끝! 화면이 "지금 무엇을 눌러야 하는지" 매번 알려주므로 순서를 외울 필요가 없습니다.
⚠️ INSTALL.bat·RUN.bat·UNINSTALL.bat을 직접 더블클릭하지 마세요. 이들은 내부 엔진입니다. 항상시작하기.bat하나만 누르면 설치 → 로그인 → 전체 기능까지 순서대로 안내합니다.
시작하기.bat를 더블클릭하면 나오는 한국어 메뉴입니다. 맨 위에 **현재 상태(설치/로그인)**와
지금 누를 번호 추천이 표시됩니다.
| 번호 | 메뉴 | 무엇을 하나 | 비고 |
|---|---|---|---|
| 1 | 처음 설정 | Supabase를 설치 (Scoop→Git→Supabase) | 처음 한 번. 관리자 권한 불필요 |
| 2 | 로그인 | 내 Supabase 계정에 연결 | 인터넷 프로젝트 쓰기 전 필요 |
| 3 | 새 프로젝트 | 이 폴더에 Supabase 설정 파일 생성 | 기존 파일은 지우지 않음 |
| 4 | 프로젝트 연결 | 이미 만든 온라인 프로젝트에 연결 | 프로젝트 ID 필요 |
| 5 | 로컬 개발 시작 | 내 컴퓨터에서 미리보기 | Docker 필요 |
| 6 | 전체 기능 메뉴 | 41가지 고급 기능 전부 | 되돌릴 수 없는 작업 포함, 주의 |
| 7 | 사용 설명서 보기 | 왕초보가이드를 메모장으로 열기 | |
| 8 | 제거 | Supabase만 깨끗이 지우기 | Git·Docker·내 파일은 유지 |
| 9 | 문제 해결 | 상태 점검 + 자가 해결 (안 될 때 여기!) | 차단 풀기·재점검·설명서 |
| 0 | 끝내기 | 창 닫기 |
로그인 상태 감지 개선: 로그인 토큰은 Windows에서 보통 자격 증명 관리자에 저장됩니다. 이 키트는 그곳과 파일을 모두 확인해, 로그인했는데도 "안 됨"으로 잘못 보이던 문제를 줄였습니다.
[시작하기.bat 더블클릭]
│
▼
(1) 처음 설정 ── Supabase 설치
│
▼
(2) 로그인 ───── 내 계정 연결
│
├───────────────┐
▼ ▼
(4) 프로젝트 연결 (3) 새 프로젝트
= 인터넷 내 DB 사용 = 이 폴더에 새로 시작
(Docker 불필요) │
│ ▼
│ (5) 로컬 개발 시작 (Docker 필요)
│ Studio: http://localhost:54323
▼
(6) 전체 기능 메뉴에서 실제 작업
│ (마이그레이션·함수·시크릿·DB 등)
▼
(8) 다 쓰면 제거 / (9) 막히면 문제 해결
초보자 추천 경로: 1 설치 → 2 로그인 → 4 연결 → 6 전체 기능 (Docker 없이 인터넷 프로젝트 사용).
"이 메뉴가 실제로 어떤 명령을 실행하는지" 궁금한 분을 위한 표입니다. (직접 입력할 필요는 없습니다.)
| 메뉴 / 작업 | 실제 실행 명령어 |
|---|---|
| 1 처음 설정 | scoop install supabase (Scoop·Git 자동 준비 포함) |
| 2 로그인 | supabase login |
| 로그아웃(전체 기능 안) | supabase logout --yes (자격 증명 관리자·파일 모두 정리) |
| 3 새 프로젝트 | supabase init |
| 4 프로젝트 연결 | supabase link --project-ref <프로젝트ID> |
| 5 로컬 개발 시작 | supabase start (Docker 필요) |
| 로컬 개발 중지 | supabase stop |
| 상태 확인 | supabase status |
| DB 가져오기 | supabase db pull |
| DB 반영(원격) | supabase db push (🔴 인터넷 진짜 DB 변경 — 대문자 YES 확인) |
| DB 초기화(로컬) | supabase db reset |
| 마이그레이션 새로 | supabase migration new <이름> |
| 마이그레이션 적용 | supabase migration up |
| 함수 새로 만들기 | supabase functions new <이름> |
| 함수 배포 | supabase functions deploy <이름> |
| 시크릿 보기/설정 | supabase secrets list / supabase secrets set |
| 타입 생성 | supabase gen types typescript |
| 프로젝트 목록 | supabase projects list |
| 버전 확인 | supabase --version |
| 전체 도움말 | supabase --help |
전체 41가지 기능은 메뉴
6(전체 기능 메뉴)에서 번호로 고를 수 있습니다.
가장 쉬운 1차 해결: 메뉴 9 문제 해결을 누르세요. 상태를 다시 점검하고, 다운로드 차단 풀기,
설명서 열기 등을 한 번에 할 수 있습니다.
| 화면에 이렇게 뜨면 | 뜻 | 이렇게 하세요 |
|---|---|---|
Supabase CLI is not installed |
아직 설치 안 됨 | 메뉴 1로 설치 |
| 설치했는데 계속 "설치 안 됨" | 새 위치를 아직 못 읽음 | 창을 닫고 시작하기.bat 다시 더블클릭 |
Scoop install may need a terminal restart |
설치 후 새 창 필요 | 창을 닫고 다시 실행 |
| "Windows의 PC 보호"(파란 경고) | 인터넷 파일 안전 확인 | 추가 정보 → 실행, 또는 메뉴 9의 "다운로드 차단 풀기" |
| 로그인 시 브라우저가 안 열림 | 기본 브라우저/네트워크 문제 | 화면의 주소(URL)를 복사해 브라우저에 붙여넣기 (가이드 2번) |
Cannot connect to the Docker daemon |
Docker가 안 켜짐 | Docker Desktop 실행(초록불) 후 다시, 또는 인터넷 프로젝트(2→4) 사용 |
Cannot find project ref / not linked |
프로젝트 미연결 | 메뉴 4로 연결 먼저 |
network / timeout / dial tcp |
인터넷·방화벽 문제 | 인터넷 확인, 회사망이면 잠시 후 재시도, 백신/방화벽 일시 해제 |
막히면 창을 닫고
시작하기.bat를 다시 더블클릭하는 것만으로 절반은 해결됩니다. 오류 글자는 마우스로 긁어 복사해 두면 도움받을 때 그대로 보여줄 수 있습니다.
- 메뉴
8(제거)를 누르면 Supabase만 깨끗하게 지웁니다. (관리자 권한 없이) - 지워지는 것: Supabase CLI, (원하면) 설정 폴더
- 안 지워지는 것: Git, Docker, 내가 만든 프로젝트 파일 — 안심하세요.
- 🔴 되돌릴 수 없는 작업(인터넷 DB에 반영, 데이터 초기화, 함수 삭제)은 한국어 시작 메뉴(1~9)에
일부러 넣지 않았습니다. 전체 기능 메뉴(
6)에서만 나오고, 실행 전 한 번 더 확인합니다. - 💰
DB Push는 인터넷의 진짜(원격) 데이터베이스를 바꿉니다. 이번 버전에서 대문자YES를 입력해야만 진행하도록 확인을 강화했습니다. 연결된 프로젝트가 맞는지 확인하세요. 무료 한도(약 500MB)를 넘으면 과금되거나 막힐 수 있습니다. - 🟡 로그인 토큰(비밀 출입증)은 비밀번호와 같습니다. 화면 공유 중에는 남에게 보이지 않게 하세요.
- 🟢 헷갈리면 언제든
0으로 끝내고시작하기.bat로 다시 시작하면 됩니다.
이 키트 폴더 안의 구성입니다.
| 파일 | 설명 |
|---|---|
| 시작하기.bat | 👉 여기서 시작 (한국어 안내 화면) |
| 왕초보가이드.md / .pdf | 그림처럼 따라 하는 단계별 설명서 (한국어) |
| README.md / .pdf | 전체 설명서 (한국어, 이 문서) |
| README.en.md / .pdf | 전체 설명서 (English) |
| GUIDE.en.md / .pdf | 왕초보 가이드 (English) |
| lib\start.ps1 | 한국어 메뉴의 실제 내용 (직접 열 필요 없음) |
| INSTALL.bat | 설치 엔진 — 직접 더블클릭 비권장 |
| RUN.bat | 41가지 전체 기능 메뉴(고급) — 직접 더블클릭 비권장 |
| UNINSTALL.bat | 안전 제거 엔진 — 직접 더블클릭 비권장 |
| LICENSE | 이 키트의 라이선스 (Apache-2.0) |
| NOTICE | 저작권·상표·제3자 도구 출처 안내 |
문서는 키트 폴더 최상위에 MD(글 파일)와 PDF가 짝으로 들어 있습니다. 내용은 동일합니다.
아래는 엄격한 기준으로 정리했습니다. 자세한 원문은
LICENSE·NOTICE파일과 각 도구의 공식 저장소를 확인하세요.
- 라이선스: Apache License 2.0 — © 2026 SoDam AI Studio. 자유롭게 사용·수정·재배포 가능 (라이선스·저작권 고지 유지, 변경 사항 표시).
| 도구 | 라이선스 | 상업적 사용 |
|---|---|---|
| Supabase CLI (© Supabase, Inc.) | MIT | 자유 (상업적 사용 가능) |
| Scoop | Unlicense / MIT | 자유 |
| Git | GPLv2 | 자유 (도구로서 사용) |
| Docker Desktop (선택) | Docker Subscription Service Agreement |
Docker Desktop은 다음 조건에서 무료입니다: 개인 사용, 교육, 비상업 오픈소스, 또는 소규모 사업체(직원 250명 미만 그리고 연매출 1,000만 달러 미만). 이 기준을 둘 중 하나라도 초과하는 조직(직원 250명 이상 또는 연매출 1,000만 달러 이상)이 상업적으로 쓰려면 유료 구독(Pro/Team/Business) 이 필요합니다. 정확한 최신 조건은 공식 약관을 확인하세요: https://docs.docker.com/subscription/desktop-license/
Docker Desktop은 선택 사항입니다. 인터넷 프로젝트만 쓰면(메뉴 2→4) Docker가 필요 없으므로 이 조건과 무관합니다.
- "Supabase"는 Supabase, Inc.의 상표입니다. "Docker"는 Docker, Inc.의 상표입니다.
- 이 키트는 비공식 헬퍼이며 Supabase, Inc. · Docker, Inc. 와 제휴·후원·보증 관계가 없습니다.
- 이 키트는 위 도구들을 재배포하지 않습니다. 각 도구는 공식 출처에서 사용자의 컴퓨터로 직접 내려받아 설치되며, 각 도구의 라이선스·약관·요금 정책이 적용됩니다.