OSS 시작하기
GitPod
Logto를 위한 온라인 GitPod 워크스페이스를 시작하려면 여기를 클릭하세요. 잠시 기다리면 다음과 같은 메시지가 표시됩니다:
Logto는 기본적으로 핵심 서비스에 포트 3001을, 인터랙티브 Admin Console에 포트 3002를 사용합니다.
Logto 여정을 계속하려면 Ctrl (또는 Cmd) 키를 누른 채 https://3002-...로 시작하는 링크를 클릭하세요. 즐기세요!
로컬
Logto를 호스팅하기 위한 최소 권장 하드웨어 사양은 다음과 같습니다:
- vCPU: 2
- 메모리: 8 GiB
- 디스크: 256 GiB
- Docker Compose
- Docker
- npm-init
Docker Compose CLI는 일반적으로 Docker Desktop에 포함되어 있습니다.
프로덕션 환경에서는 우리의 docker compose 명령을 사용하지 마세요! 현재 docker-compose.yml에서 Logto 앱과 함께 내장된 Postgres 데이터베이스가 번들로 제공되기 때문에,
명령을 다시 실행할 때마다 새로운 데이터베이스 인스턴스가 생성되며, 이전에 저장된 모든 데이터가 손실됩니다.
curl -fsSL https://raw.githubusercontent.com/logto-io/logto/HEAD/docker-compose.yml | docker compose -p logto -f - up
구성이 성공적으로 완료되면 다음과 같은 메시지가 표시됩니다:
1단계
PostgreSQL@^14.0 인스턴스를 준비하고, Logto CLI를 사용하여 Logto용 데이터베이스를 시드하세요:
- CLI
- npx
logto db seed
npx @logto/cli db seed
2단계
이미지를 가져옵니다:
# ghcr
docker pull ghcr.io/logto-io/logto:latest
# DockerHub
docker pull svhd/logto:latest
3단계
컨테이너 포트를 Logto core 및 admin 앱에 매핑하세요. 예: 3001:3001 및 3002:3002; 그리고 다음 환경 변수를 컨테이너에 설정하세요:
TRUST_PROXY_HEADER: 1 # Logto 앞에 HTTPS 프록시(예: Nginx)가 있다면 1로 설정
ENDPOINT: https://<your-logto-domain> # (선택 사항) 커스텀 도메인을 사용하는 경우 Logto 엔드포인트 URL로 교체
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (선택 사항) 커스텀 도메인을 사용하는 경우 Logto admin URL로 교체
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Postgres DSN으로 교체
DATABASE_STATEMENT_TIMEOUT: DISABLE_TIMEOUT # (v1.36.0+) PgBouncer/RDS Proxy용 statement_timeout 비활성화
위 필수 환경 변수(선택 사항은 아래에 생략, 필요시 추가)를 사용하여 컨테이너를 실행하세요:
docker run \
--name logto \
-p 3001:3001 \
-p 3002:3002 \
-e TRUST_PROXY_HEADER=1 \
-e ENDPOINT=https://<your-logto-domain> \
-e ADMIN_ENDPOINT=https://<your-logto-admin-domain> \
-e DB_URL=postgres://username:password@your_postgres_url:port/db_name \
ghcr.io/logto-io/logto:latest
- Docker Hub를 사용하는 경우
ghcr.io/logto-io/logto:latest대신svhd/logto:latest를 사용하세요. DB_URL에서 호스트 IP를 참조하려면host.docker.internal또는172.17.0.1을 사용하세요.- PgBouncer 또는 RDS Proxy를 사용 중이고
unsupported startup parameter: statement_timeout오류가 발생하면DATABASE_STATEMENT_TIMEOUT=DISABLE_TIMEOUT(v1.36.0+)을 설정하세요.
마지막으로 다음과 같은 메시지가 표시됩니다:
사전 준비 사항
- Node.js
^18.12.0 - PostgreSQL
^14.0
더 높은 버전도 일반적으로 동작하지만 보장되지는 않습니다.
Logto 전용의 새로운 빈 데이터베이스 사용을 권장하지만, 필수는 아닙니다.
다운로드 및 시작
터미널에서 다음을 실행하세요:
npm init @logto@latest
초기화 과정을 완료하고 Logto를 시작하면 다음과 같은 메시지가 표시됩니다:
Core app is running at http://localhost:3001
Core app is running at https://your-domain-url
Admin app is running at http://localhost:3002
Admin app is running at https://your-admin-domain-url
http://localhost:3002/로 이동하여 Logto 여정을 계속하세요. 즐기세요!
대체 URL로 다운로드하기
Logto zip 파일의 URL을 지정하려면 --download-url 옵션을 사용하세요. 예시:
npm init @logto@latest -- --download-url=https://github.com/logto-io/logto/releases/download/v1.2.2/logto.tar.gz
NPM이 인자를 전달하려면 추가 --가 필요합니다.
더 고급 제어나 프로그래밍 방식 접근이 필요하다면 Core service를 확인하세요.
호스팅 제공업체
이 신뢰할 수 있는 호스팅 제공업체들은 Logto를 위한 원클릭 설치 템플릿을 제공합니다. 손쉽게 배포 가능한 서비스를 통해 Logto를 사용하여 CIAM 시스템을 몇 초 만에 구축하고 시작할 수 있습니다.
무료 개발 테넌트로 손쉽게 인증 (Authentication) 통합이 가능한 비용 효율적인 클라우드 서비스입니다.
앱 및 데이터베이스 관리를 쉽게 할 수 있는 자체 호스팅 Heroku/Netlify 대안입니다.
자체 인프라에 앱을 배포할 수 있는 경량 툴입니다.
Docker로 클라우드 서버를 관리할 수 있는 현대적인 컨트롤 패널입니다.
코드 및 오픈소스 소프트웨어 배포를 위한 완전 관리형 DevOps 플랫폼입니다.
앱 배포 및 인프라 관리를 간소화합니다.
개발자를 위한 앱 배포, 확장, 모니터링을 간소화합니다.
타사 서비스 제공업체에 대해서는 고객 지원을 제공하지 않습니다. 저희 지원 채널을 이용하려면 Logto Cloud에 배포해 주세요. 감사합니다!
계정 생성하기
서버에 Logto를 성공적으로 호스팅한 후, 환영 페이지에서 "계정 생성"을 클릭하세요. Logto 오픈소스 버전은 최초 실행 시 한 번만 계정 생성을 허용하며, 여러 계정 생성을 지원하지 않습니다. 계정 생성은 사용자 이름과 비밀번호 조합으로만 제한됩니다.
Logto OSS (셀프 호스팅)는 여러 관리자를 구성할 수 없습니다. 팀 협업이나 여러 관리자 사용자가 필요한 프로젝트의 경우, 전체 팀 관리 기능을 제공하는 Logto Cloud 사용을 권장합니다.
관련 리소스
로컬 HTTPS 개발 다루기Logto 커뮤니티 기여 리소스 모음