Docker Override

Gebruik een docker-compose.override.yml bestand om de Docker-configuratie van LibreChat aan te passen zonder het hoofd-bestand docker-compose.yml te bewerken.

Een Docker Compose override-bestand stelt je in staat om de standaardconfiguratie in docker-compose.yml te wijzigen zonder deze te bewerken of te dupliceren. Override-bestanden zijn voornamelijk bedoeld voor lokale aanpassingen. Wanneer je docker compose up uitvoert, voegt Compose docker-compose.yml automatisch samen met docker-compose.override.yml.

Meer voorbeelden

Zie docker-compose.override.yml.example in de repository voor een uitgebreidere set override-snippets die je kunt kopiëren.

Configureer de Override

Maak het override-bestand aan. Als je er nog geen hebt, kopieer dan het voorbeeld. Docker Compose pakt dit automatisch op wanneer je docker compose commando's uitvoert.

cp docker-compose.override.yml.example docker-compose.override.yml

Bewerk het override-bestand. Open docker-compose.override.yml in je editor, haal vervolgens de commentaartekens weg bij de secties die je nodig hebt en pas deze aan.

Eén item per service

Elke servicenaam (api, mongodb, meilisearch, ...) mag slechts één keer voorkomen. Om meerdere instellingen voor één service te overschrijven, combineer je ze onder dat ene item.

Pas de wijzigingen toe. Voer Docker Compose uit zoals gebruikelijk. Het voegt docker-compose.yml en docker-compose.override.yml voor je samen.

docker compose up -d

Controleer de wijzigingen. Geef de actieve containers en hun eigenschappen weer, zoals poorten, om te bevestigen dat je overschrijvingen zijn doorgevoerd.

docker ps

Voorbeelden

Om je librechat.yaml configuratiebestand te mounten zodat Docker het kan gebruiken voor Custom Endpoints & Configuration:

services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml

Om de api image lokaal te bouwen, het configuratiebestand te mounten en een oudere MongoDB te gebruiken die geen AVX-ondersteuning vereist:

services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml
    image: librechat
    build:
      context: .
      target: node

  mongodb:
    image: mongo:4.4.18

Bekijk blootgestelde poorten

Het blootstellen van MongoDB- of Meilisearch-poorten aan het publiek kan uw gegevens kwetsbaar maken. Vermijd standaardpoorten voor productie- of gevoelige omgevingen.

`deploy-compose.yml` gebruiken

Bij gebruik van een niet-standaard Compose-bestand zoals deploy-compose.yml, wordt de override niet automatisch geladen. Geef beide bestanden expliciet door met -f (of --file); instellingen in latere bestanden overschrijven of voegen toe aan eerdere bestanden.

Het override-bestand kan elke naam hebben, hoewel je mogelijk al een docker-compose.override.yml hebt staan. Voer commando's als volgt uit:

docker compose -f deploy-compose.yml -f docker-compose.override.yml pull
docker compose -f deploy-compose.yml -f docker-compose.override.yml up

Referentie

Prioriteitsvolgorde: waarden in het override-bestand krijgen voorrang boven dezelfde waarden in docker-compose.yml.
Beveiliging: wees je bij het aanpassen van poorten en het publiekelijk blootstellen van services bewust van de beveiligingsimplicaties en vermijd standaardinstellingen voor productieomgevingen.

Voor meer details, zie de officiële Docker documentatie: