LC Config Downloader is a tool designed to facilitate the remote management of the LibreChat configuration file (librechat.yaml
). It works by downloading a specified librechat.yaml
file into a shared Docker volume, from where it can be utilized by the LibreChat container. This tool is particularly useful for scenarios requiring remote or automated configuration updates, and it supports integration with Portainer and standard Docker setups.
- Download
librechat.yaml
from a specified URL. - Easy integration with Docker and Portainer setups.
- Uses environment variables for easy customization.
- Supports fallback to a default example configuration.
To use LC Config Downloader, you'll need a Docker environment ready. The script is packaged in a Docker container for easy deployment alongside your LibreChat setup.
- Docker and Docker Compose installed on your machine.
- Basic knowledge of Docker and container management.
CONFIG_URL
– The URL from which thelibrechat.yaml
file should be downloaded. If not provided, a default example configuration will be used.
Here's how you can set it up using Docker Compose for both standard Docker installations and Portainer:
Standard Docker Installation:
-
Create a
docker-compose.override.yaml
file in your project directory. -
Use the following template and adjust values as necessary:
version: "3.4" services: api: volumes: - shared-config:/app config-downloader: container_name: ConfigDownloader image: ghcr.io/fuegovic/lc-config-downloader:latest environment: - CONFIG_URL=https://my-custom-url-to/librechat.yaml volumes: - shared-config:/shared volumes: shared-config:
Portainer Setup:
-
Define your stack in Portainer using the following configuration, adjusting as necessary:
version: "3.8" services: # LibreChat api: image: ghcr.io/danny-avila/librechat-dev:latest container_name: LibreChat ports: - 3080:3080 restart: always env_file: - stack.env volumes: - /LibreChat/images:/app/client/public/images - shared-config:/app # Config Downloader config-downloader: container_name: ConfigDownloader image: ghcr.io/fuegovic/lc-config-downloader:latest environment: - CONFIG_URL=https://my-custom-url-to/librechat.yaml volumes: - shared-config:/shared # Meilisearch (Optional) meilisearch: container_name: Meilisearch image: getmeili/meilisearch:v1.5.1 restart: always env_file: - stack.env volumes: - /LibreChat/meili_data_v1.5:/meili_data volumes: shared-config:
Deploy your configuration using Docker Compose:
docker-compose up -d
For Portainer, add the configuration as a new stack and deploy it.
Remember to replace placeholders (like repository URLs or container image paths) with actual values relevant to your setup. This README is a starting point, and you should adjust it to fit the specifics and requirements of your project more accurately.