배포가 안 될 때
앱 만들기 실패·배포 실패·접근 불가를 증상별로 좁혀서 해결하는 방법이에요.
뭔가 막혔을 때는 증상별로 좁혀가면 빨라요. 그리고 한 가지만 기억하세요 — 에러 로그는 요약하지 말고 그대로 Claude Code에 붙여넣는 게 원인을 가장 빨리 찾는 길이에요.
앱 만들 때 실패했어요
앱 만들기(부트스트랩) 진행 중 실패하면 화면에 메시지와 다시 시도 버튼이 떠요. 자주 나는 경우예요.
| 메시지 | 해결 |
|---|---|
| 같은 이름의 저장소가 이미 있어요 | Git 저장소 단계로 돌아가 다른 저장소 이름으로 다시 시도 |
| GitHub App 설치가 필요해요 | Git 저장소 단계에서 axhub GitHub App 설치를 완료 |
| 슬러그·서브 도메인 형식 오류 | 영문 소문자·숫자·하이픈만 사용 |
| 앱 생성에 실패했어요 | 일시적일 수 있어요 — 잠시 후 다시 시도 |
배포가 실패했어요
코드를 push했는데 배포 탭에 실패가 떴다면, 먼저 배포 로그를 봐요.
| 증상 | 확인할 것 |
|---|---|
| Dockerfile을 못 찾음 | 루트에 Dockerfile·Compose 파일·axhub.yaml 중 하나가 있어야 해요 |
| 빌드/실행 명령을 모름 | axhub.yaml에 build·start 명령을 적어요 (앱 개발하기) |
| 환경변수가 없다는 오류 | 환경변수에 등록했는지, Stage가 맞는지 확인 |
| 환경변수를 바꿨는데 그대로 | 환경변수 변경은 다시 배포해야 적용돼요 |
| 저장소·브랜치를 못 찾음 | GitHub 연결과 브랜치(main)를 확인 |
수정 → GitHub push → 새 배포 순서로 다시 시도하면 돼요.