KO Quickstart

Read in English

빠른 시작

이 문서는 Docker Compose로 toard 서버를 띄우고 정상 동작을 확인하는 최소 경로입니다. 팀원 수집은 설치가 끝난 뒤 KO-Roll-out-your-team에서 이어갑니다.

시작하기 전에

Docker Compose v2와 curl이 필요합니다. 외부에 공개할 서버라면 TLS와 비밀값 보관 방법도 먼저 정하세요.

docker compose version
curl --version

toard 시작

저장소를 내려받은 디렉터리에서 다음 명령을 실행합니다.

AUTH_SECRET=$(openssl rand -base64 33) docker compose up -d

AUTH_SECRET은 세션 서명에 필요한 필수값입니다. 계속 운영할 서버라면 매번 바꾸지 말고, 안전한 비밀 관리 방식으로 .env 또는 외부 secret store에 보관하세요.

첫 관리자 만들기

처음 열면 /setup에서 첫 관리자 계정을 만들 수 있습니다. 비대화형 환경에서는 BOOTSTRAP_ADMIN_EMAIL과 BOOTSTRAP_ADMIN_PASSWORD를 사용해 관리자를 미리 만들 수 있지만, 실제 값을 명령 기록이나 채팅에 남기지 마세요.

설치 확인

curl -fsS http://localhost:3000/api/health
curl -fsS http://localhost:3000/api/ready
docker compose ps -a

health와 ready가 성공하고, app과 postgres가 실행 중이며 migrate가 exited (0)이면 기본 설치가 정상입니다. 마지막으로 관리자 계정으로 로그인해 보세요.

다음 단계

팀에 배포하려면 KO-Roll-out-your-team을, Kubernetes나 Helm 같은 상세 배포는 배포 가이드를 보세요.