접속
- 브라우저 열기:
https://<SERVER_IP>/ - 자체 서명 SSL 인증서를 사용하므로 첫 방문 시 브라우저 경고가 나타나는 것이 정상입니다.
최초 설정
- 설정 페이지를 엽니다:
https://<SERVER_IP>/setup - 설정 마법사를 따라 인스턴스를 구성하세요
- This will generate a
config.jsoninside the config directory
설정 참고 사항
- For a quick setup, select
SQLite을 설정 마법사에서 데이터베이스로 선택합니다.Redis은 기본적으로 설치되지 않습니다. 필요하면 직접 설치하고 구성하세요. - 한편
Use SSL (a self-signed certificate will be generated that can be replaced), 선택No. HTTPS는 자체 서명 인증서를 사용하는 Nginx가 이미 제공합니다. - 설정
Public Facing URL을 사용자가 인스턴스에 접속할 때 쓰는 URL로 설정합니다. 기본값은 다음과 같습니다:https://<SERVER_IP>/. 나중에 도메인을 설정하면 이 값도 그에 맞게 업데이트하세요.
중요한 경로
- 설치 디렉토리:
/root/gokapi - Docker Compose 파일:
/root/gokapi/compose.yaml - 환경 파일:
/root/gokapi/.env - 데이터 저장소:
/root/gokapi/gokapi-data - 설정:
/root/gokapi/gokapi-config - Nginx 설정:
/etc/nginx/sites-available/gokapi - SSL 인증서:
/etc/nginx/ssl/gokapi.crt - SSL 키:
/etc/nginx/ssl/gokapi.key
Docker 관리
실행 중인 컨테이너 보기:
docker compose -f /root/gokapi/compose.yaml ps
모든 컨테이너 재시작:
docker compose -f /root/gokapi/compose.yaml restart
애플리케이션 로그를 확인하세요:
docker compose -f /root/gokapi/compose.yaml logs -f
애플리케이션을 중지하세요:
docker compose -f /root/gokapi/compose.yaml down
애플리케이션을 시작하세요:
docker compose -f /root/gokapi/compose.yaml up -d
Nginx 관리
상태 확인:
systemctl status nginx
Nginx 재시작:
systemctl restart nginx
Nginx 다시 로드:
systemctl reload nginx
구성을 검증하세요:
nginx -t
