OSS 시작하기
GitPod
Logto를 위한 온라인 GitPod 워크스페이스를 시작하려면, 여기를 클릭하세요. 잠시 기다리면 다음과 같은 메시지가 나타납니다:
Logto는 기본적으로 핵심 서비스에 포트 3001
을, 상호작용 관리 콘솔에 포트 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 명령을 사용하지 마세요! 현재 Logto 앱과 함께 번들로 제공되는 내장 Postgres 데이터베이스가 docker-compose.yml
에 포함되어 있어, 명령을 다시 실행할 때마다 새로운 데이터베이스 인스턴스가 생성되고 이전에 저장된 데이터는 모두 손실됩니다.
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 핵심 및 관리자 앱에 매핑합니다. 예를 들어, 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 관리자 URL로 대체
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Postgres DSN으로 대체
위의 모든 환경 변수를 사용하여 컨테이너를 실행합니다:
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
을 사용하세요.
마지막으로, 다음과 같은 메시지가 나타납니다:
필수 조건
- 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이 인수를 전달하도록 하기 위해 추가 --
가 필요합니다.
Logto에 대한 더 고급의 제어나 프로그래밍적 접근이 필요하다면 핵심 서비스를 확인하세요.
호스팅 제공자
이 신뢰할 수 있는 호스팅 제공자들은 Logto를 위한 원클릭 설치 템플릿을 제공합니다. 쉽게 배포 가능한 서비스를 통해 Logto를 사용하여 CIAM 시스템을 몇 초 만에 설정하고 시작할 수 있습니다.
간편한 인증 통합을 위한 무료 개발 테넌트를 제공하는 비용 효율적인 클라우드 서비스입니다.
쉽게 앱과 데이터베이스를 관리할 수 있는 자체 호스팅 가능한 Heroku/Netlify 대안입니다.
자신의 인프라에 앱을 배포하기 위한 경량 도구입니다.
Docker로 클라우드 서버를 관리하기 위한 현대적인 제어판입니다.
코드와 오픈 소스 소프트웨어를 배포하기 위한 완전 관리형 DevOps 플랫폼입니다.
앱 배포 및 인프라 관리를 간소화합니다.
개발자를 위한 앱 배포, 확장 및 모니터링을 간소화합니다.
타사 서비스 제공자에 대한 고객 지원은 제공하지 않습니다. 지원 채널에 접근하려면 Logto Cloud에 배포해 주세요. 감사합니다!
계정 생성
Logto를 서버에 성공적으로 호스팅한 후, 환영 페이지에서 "계정 생성"을 클릭하세요. Logto의 오픈 소스 버전은 초기 실행 시 하나의 계정 생성만 허용하며, 여러 계정을 지원하지 않습니다. 계정 생성 과정은 사용자 이름과 비밀번호 조합으로 제한됩니다.