Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack ๐ŸŽ‰ Learn more
LibreChat

Helm Chart

Instruksi untuk men-deploy LibreChat di Kubernetes menggunakan Helm

Silakan ikuti panduan ini untuk men-deploy LibreChat pada Kubernetes menggunakan Helm, dengan menyesuaikan kebutuhan sesuai kasus penggunaan spesifik Anda. Helm chart lain yang dikontribusikan oleh komunitas tercantum di bawah ini pada bagian Community Helm Charts.

Prasyarat

  • Klaster Kubernetes yang sedang berjalan
  • Instalasi lokal kubectl dan Helm

Konfigurasi

  1. Gunakan Credentials Generator untuk menghasilkan nilai aman bagi CREDS_KEY, JWT_SECRET, JWT_REFRESH_SECRET, dan MEILI_MASTER_KEY.

Tempatkan nilai-nilai tersebut ke dalam Kubernetes Secret seperti ini (jika Anda mengubah nama secret, jangan lupa untuk memperbarui nilai Helm Anda):

apiVersion: v1
kind: Secret
metadata:
  name: librechat-credentials-env
  namespace: <librechat-chart-namespace>
type: Opaque
stringData:
  CREDS_KEY: <generated value>
  JWT_SECRET: <generated value>
  JWT_REFRESH_SECRET: <generated value>
  MEILI_MASTER_KEY: <generated value>
  1. Tambahkan ke secret yang sama ini semua API key yang diperlukan untuk penyedia LLM:
apiVersion: v1
kind: Secret
metadata:
  name: librechat-credentials-env
  namespace: <librechat-chart-namespace>
. . . .

  OPENAI_API_KEY: <your secret value>
  1. Terapkan Secret ke Cluster:

Instal Helm Chart

Untuk menginstal helm chart, jalankan:

helm install <deployment-name> oci://ghcr.io/danny-avila/librechat-chart/librechat

Versi pengembangan

Di direktori root repo, jalankan:

helm install <deployment-name> ./helm/librechat

Mirip dengan chart Helm lainnya, terdapat values file yang menguraikan pengaturan default dan menunjukkan opsi konfigurasi mana yang dapat dimodifikasi.

Buat file values.yaml yang diisi dengan nilai-nilai yang ingin Anda ubah dari nilai default.

Instal Helm chart: helm install librechat oci://ghcr.io/danny-avila/librechat-chart/librechat --values <values-override-filel>

Menghapus Helm Chart

Untuk menghapus Helm Chart: helm uninstall <deployment-name>

Contoh: helm uninstall librechat

Migrasi 1.x -> 2.x

Jika Anda menggunakan chart sebelum versi 2.x, Anda mungkin perlu memperbarui struktur value.

  1. Pindahkan Konfigurasi ke librechat.configEnv:
- env:
-     ALLOW_EMAIL_LOGIN: "true"
-     ALLOW_REGISTRATION: "true"
+ librechat:
+   configEnv:
+     ALLOW_REGISTRATION: "true"
+     ALLOW_EMAIL_LOGIN: "true"
  1. Gabungkan semua nilai Secret menjadi satu Secret sebagaimana dijelaskan dalam Configuration Step 1.
  2. Untuk memanfaatkan instans MongoDB eksternal, lihat values file dari Chart tersebut, nonaktifkan komponen yang sesuai, dan ubah FQDN dari instans MongoDB. Hal ini direkomendasikan jika data sudah ada di dalam instans MongoDB yang dikelola secara eksternal ini.

Helm Chart Komunitas

Bagaimana panduan ini?