Skip to main content
LangSmith 자체 호스팅은 가장 규모가 크고 보안을 중시하는 고객을 위해 설계된 엔터프라이즈 플랜의 추가 기능입니다. 자세한 내용은 가격 페이지를 참조하고, 사용자의 환경에서 LangSmith를 시험해볼 수 있는 라이선스 키를 받으려면 영업팀에 문의하세요.
이 가이드는 개발 및 테스트 목적으로 Docker를 사용하여 LangSmith 플랫폼을 로컬에서 실행하는 방법을 안내합니다.
개발/테스트 전용입니다. 프로덕션 환경에서는 Docker Compose를 사용하지 마세요. 프로덕션 배포에는 Kubernetes를 사용하세요.
이 페이지는 로컬 테스트를 위한 기본 LangSmith 플랫폼 설치 방법을 설명합니다. 배포 관리 기능은 포함되지 않습니다. 자세한 내용은 자체 호스팅 옵션을 검토하세요.
Docker Compose는 로컬 개발 환경으로만 제한되며, AWS Elastic Container Service, Azure Container Instances, Google Cloud Run과 같은 컨테이너 서비스는 지원하지 않습니다.

​
사전 요구사항

  1. 시스템에 Docker가 설치되어 있고 실행 중인지 확인합니다. 다음 명령으로 확인할 수 있습니다: 
    docker info
    출력에 서버 정보가 표시되지 않으면 Docker가 올바르게 설치되었는지 확인하고 Docker 데몬을 실행하세요.
    1. 권장 사양: 최소 4 vCPU, 16GB 메모리
      • 조직 규모/사용량에 따라 다양한 서비스의 리소스 요청/제한을 조정해야 할 수 있습니다
    2. 디스크 공간: LangSmith는 많은 디스크 공간이 필요할 수 있습니다. 충분한 디스크 공간이 있는지 확인하세요.
  2. LangSmith 라이선스 키
    1. LangChain 담당자로부터 받을 수 있습니다. 자세한 정보는 영업팀에 문의하세요.
  3. API 키 솔트(Salt)
    1. 생성할 수 있는 비밀 키입니다. 무작위 문자열이어야 합니다.
    2. 다음 명령으로 생성할 수 있습니다:
    openssl rand -base64 32
  4. https://beacon.langchain.com에 대한 송신(Egress) (오프라인 모드가 아닌 경우)
    1. LangSmith는 라이선스 검증 및 사용량 보고를 위해 https://beacon.langchain.com에 대한 송신이 필요합니다. 이는 LangSmith가 올바르게 작동하기 위해 필수입니다. 송신 요구사항에 대한 자세한 내용은 송신 섹션을 참조하세요.
  5. 구성
    1. .env 파일에서 설정할 수 있는 여러 구성 옵션이 있습니다. 사용 가능한 구성 옵션에 대한 자세한 내용은 구성 섹션을 참조하세요.

​
Docker Compose로 실행하기

다음은 Docker Compose를 사용하여 LangSmith를 실행하는 방법을 설명합니다. 이는 Kubernetes 없이 LangSmith를 실행하는 가장 유연한 방법입니다. Docker Compose의 기본 구성은 로컬 테스트 전용으로 설계되었으며, 공용 인터넷에 노출되는 서비스에는 적합하지 않습니다. 프로덕션 환경에서는 보안이 강화된 Kubernetes 환경을 사용하는 것을 강력히 권장합니다.

​
1. LangSmith docker-compose.yml 파일 가져오기

docker-compose.yml 파일 및 관련 파일은 LangSmith SDK 저장소에서 찾을 수 있습니다: LangSmith Docker Compose 파일 LangSmith SDK에서 docker-compose.yml 파일과 해당 디렉터리의 모든 파일을 프로젝트 디렉터리로 복사합니다.
  • users.xml 파일도 함께 복사해야 합니다.

​
2. 환경 변수 구성하기

  1. LangSmith SDK의 .env.example 파일을 프로젝트 디렉터리로 복사하고 .env로 이름을 변경합니다.
  2. .env 파일에서 적절한 값을 구성합니다. 사용 가능한 구성 옵션은 구성 섹션에서 찾을 수 있습니다.
이러한 환경 변수를 docker-compose.yml 파일에 직접 설정하거나 터미널에서 내보낼 수도 있습니다. .env 파일에 설정하는 것을 권장합니다.

​
3. 서버 시작하기

터미널에서 다음 명령을 실행하여 LangSmith 애플리케이션을 시작합니다: 
docker-compose up
다음 명령으로 백그라운드에서 서버를 실행할 수도 있습니다: 
docker-compose up -d

​
배포 검증하기:

  1. cli-langchain-frontend-1 컨테이너의 노출된 포트에 curl 요청 보내기: 
    curl localhost:1980/info{"version":"0.5.7","license_expiration_time":"2033-05-20T20:08:06","batch_ingest_config":{"scale_up_qsize_trigger":1000,"scale_up_nthreads_limit":16,"scale_down_nempty_trigger":4,"size_limit":100,"size_limit_bytes":20971520}}
  2. 브라우저에서 cli-langchain-frontend-1 컨테이너의 노출된 포트 방문하기 LangSmith UI는 http://localhost:1980에서 표시되고 작동해야 합니다 .langsmith_ui.png

​
로그 확인하기

언제든지 서버가 실행 중인지 확인하고 로그를 보려면 다음을 실행합니다 
docker-compose logs

​
서버 중지하기

docker-compose down

​
LangSmith 사용하기

이제 LangSmith가 실행 중이므로 코드를 추적하는 데 사용할 수 있습니다. 자체 호스팅 LangSmith 사용 방법에 대한 자세한 내용은 자체 호스팅 사용 가이드를 참조하세요. LangSmith 인스턴스가 실행 중이지만 아직 완전히 설정되지 않았을 수 있습니다. 기본 구성 중 하나를 사용한 경우, 인증이 없는 구성을 배포했을 수 있습니다. 이 상태에서는 인증이나 사용자 계정 개념, API 키가 없으며, 호스트명이 LangChain tracer/LangSmith SDK에 전달되기만 하면 API 키 없이 직접 추적을 제출할 수 있습니다. 다음 단계로, 인프라 관리자와 협력하여 다음을 수행하는 것을 강력히 권장합니다:
  • LangSmith 인스턴스에 대한 DNS 설정으로 더 쉽게 액세스 활성화
  • LangSmith에 제출되는 추적의 전송 중 암호화를 보장하도록 SSL 구성
  • LangSmith 인스턴스를 보호하기 위해 OAuth 인증 또는 기본 인증 구성
  • LangSmith 프론트엔드 및 API에만 액세스를 제한하도록 Docker 환경에 대한 액세스 보안
  • 보안이 강화된 Postgres 및 Redis 인스턴스에 LangSmith 연결
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I