기본 설치 가이드는 리눅스 서버 기준으로 작성되어 있습니다.
설치 작업을 수행하는 PC와 실제 설치 대상 서버가 서로 분리된 환경을 전제로 합니다.
배포 파일 업로드와 브라우저 접속은 작업자 PC에서 진행하고, 압축 해제와 Docker 실행은 서버 SSH 접속 화면에서 진행하기 때문입니다.
명령 실행 위치를 구분해서 보는 것이 가장 중요합니다.
설치 페이지는 백엔드 8000 포트에서 열립니다.
예: http://서버IP:8000/install
일반 프론트 화면은 http://서버IP 로 접속합니다.
80 포트는 일반 웹 접속용 프론트 화면입니다.
8000 포트는 설치 페이지와 백엔드 동작 확인에 사용하는 주소입니다.
현재 배포 가이드는 Docker Compose 기준으로 안내하고 있습니다.
기본 설치 흐름에서는 Docker와 Docker Compose가 준비되어 있어야 합니다.
설치 전에는 최소한 DB_NAME, DB_USER, DB_PASSWORD, DB_BOOTSTRAP_PASSWORD, SESSION_SECRET_KEY, NGINX_MODE 를 먼저 확인해 주세요.
change-this-... 형태의 기본값은 운영 전에 반드시 변경합니다.
먼저 컨테이너 실행 상태, 80/8000 포트 개방 여부, .env 설정값, 공유기 또는 방화벽 포트 설정을 순서대로 확인합니다.
대부분은 포트 설정 또는 Docker 실행 상태에서 먼저 문제가 발견됩니다.
