Skip to main content

Authentik Docker Compose로 실행하기

이 문서는 Docker Compose를 사용하여 Authentik을 설치하고 실행하는 방법을 안내합니다. 이 방법은 테스트 환경이나 소규모 프로덕션 환경에 적합합니다.

사전 요구사항​

  • 최소 2개 이상의 CPU 코어와 2GB 이상의 RAM을 갖춘 호스트
  • Docker
  • Docker Compose (v2 이상)

준비 단계​

  1. docker-compose.yml 파일 다운로드: 터미널을 열고 원하는 디렉토리로 이동한 후, 다음 명령어를 실행하여 최신 docker-compose.yml 파일을 다운로드합니다.

    wget https://goauthentik.io/docker-compose.yml

    또는 curl을 사용할 수도 있습니다:

    curl -O https://goauthentik.io/docker-compose.yml

  2. 비밀번호 및 시크릿 키 생성: 새로 Authentik을 설치하는 경우, PostgreSQL 데이터베이스 비밀번호와 Authentik 시크릿 키를 생성해야 합니다. 다음 명령어를 실행하여 .env 파일에 자동으로 저장할 수 있습니다.

    # PostgreSQL 비밀번호 생성
    echo "PG_PASS=$(openssl rand -base64 36 | tr -d '\\n')" >> .env

    # Authentik 시크릿 키 생성
    echo "AUTHENTIK_SECRET_KEY=$(openssl rand -base64 60 | tr -d '\\n')" >> .env

  3. (선택) 오류 리포팅 활성화: 오류 리포팅을 활성화하려면 다음 명령어를 실행하세요.

    echo "AUTHENTIK_ERROR_REPORTING__ENABLED=true" >> .env

실행​

준비가 완료되면 다음 명령어를 실행하여 Authentik을 시작합니다.

  1. 최신 이미지 다운로드:

    docker compose pull

  2. 컨테이너 실행:

    docker compose up -d

초기 설정​

Authentik이 실행되면 웹 브라우저를 열고 다음 주소로 이동하여 초기 설정을 시작합니다.

http://<서버 IP 또는 호스트명>:9000/if/flow/initial-setup/

중요: 주소 끝에 반드시 /를 포함해야 합니다. 그렇지 않으면 Not Found 오류가 발생합니다.

초기 설정 페이지에서 기본 관리자 사용자인 akadmin의 비밀번호를 설정하라는 메시지가 표시됩니다.