Ubuntu 24.04에 오픈 소스 AI 채팅 플랫폼 LibreChat 배포하기

LibreChat은 OpenAI, Anthropic, Azure OpenAI, Gemini, OpenRouter, 로컬 OpenAI 호환 엔드포인트 등을 지원하며, MongoDB 기반의 대화 기록과 Meilisearch 기반의 검색 기능을 갖춘 오픈 소스(open-source) ChatGPT 스타일의 웹 UI입니다. 이 가이드는 공식 Compose 매니페스트와 자동 HTTPS를 위한 Traefik 오버라이드(override)를 사용하여 LibreChat을 배포합니다. 이 과정을 마치면 여러분의 도메인에서 HTTPS를 통해 등록 페이지와 멀티 프로바이더(multi-provider) 채팅 기능이 포함된 LibreChat을 실행할 수 있게 됩니다.

LibreChat 클론 및 환경 준비

1. LibreChat 저장소를 클론하고 안정적인 태그를 체크아웃합니다:

$ git clone https://github.com/danny-avila/LibreChat.git
$ cd LibreChat
$ git checkout tags/v0.8.3

2. 이 릴리스에 고정된 Meilisearch 데이터 디렉토리 이름을 찾습니다:

$ grep -o 'meili_data_v[0-9.]*' docker-compose.yml | head -1

3. 필요한 데이터 디렉토리를 생성합니다 (이전 명령어가 다른 이름을 출력했다면 meili_data_v1.35.1을 해당 이름으로 교체하세요):

$ mkdir -p data-node images logs meili_data_v1.35.1 uploads
$ sudo chown -R 1000:1000 meili_data_v1.35.1

4. env 템플릿을 복사하고 UID/GID 라인의 주석을 해제합니다:

$ cp .env.example .env
$ nano .env

UID=1000
GID=1000

Traefik으로 Compose 스택 오버라이드하기

1. Traefik을 추가하고 API를 연결하는 Compose 오버라이드를 생성합니다:

$ nano docker-compose.override.yml

services:
  api:
    labels:
...

2. 빈 LibreChat 설정 파일을 생성합니다 (오버라이드에 의해 마운트됨):

$ touch librechat.yaml

스택 시작하기

1. 모든 서비스를 올립니다:

$ docker compose up -d

Compose는 LibreChat API, MongoDB, Meilisearch, 그리고 Traefik을 시작합니다. Traefik은 HTTP-01 챌린지를 통해 Let's Encrypt로부터 TLS 인증서를 요청하고, 3080 포트의 LibreChat으로 HTTPS를 라우팅합니다.

2. 컨테이너가 실행 중인지 확인합니다:

$ docker compose ps

3. 로그를 확인합니다:

$ docker compose logs --tail=50

MongoDB가 초기화되고, Meilisearch가 시작되며, Traefik이 경로(route)를 등록하고, LibreChat API가 3080 포트에서 대기 중인 것을 확인할 수 있습니다.

등록 및 로그인

1. 브라우저에서 등록 페이지를 엽니다:

2. 이름, 사용자 이름(username), 이메일, 비밀번호를 입력하고 Continue를 클릭합니다.

3. 새로운 자격 증명으로 로그인합니다 — 모델 선택기(model selector)와 대화 인터페이스가 포함된 대시보드가 로드됩니다.

Google / GitHub / Discord / OpenID Connect 회원가입을 활성화하려면, .env 파일에서 ALLOW_SOCIAL_LOGIN=true 및 ALLOW_SOCIAL_REGISTRATION=true로 설정한 후 스택을 재시작하세요.

다음 단계

LibreChat이 실행 중이며 HTTPS를 통해 안전하게 서비스되고 있습니다. 이제 다음 작업들을 수행할 수 있습니다:

• .env 파일에 OpenAI, Anthropic, Azure, Gemini 또는 OpenRouter를 위한 API 키 입력
• librechat.yaml을 통해 LibreChat을 로컬 OpenAI 호환 엔드포인트(Ollama, LocalAI)로 연결
• 대시보드 설정을 통해 파일 업로드, RAG(검색 증강 생성), 이미지 생성 활성화

추가적인 팁이 포함된 전체 가이드는 **Vultr Docs**의 원문 기사를 방문하여 확인하세요.