chore: configure data volume

Signed-off-by: Ettore Di Giacinto <mudler@localai.io>

Author: mudler

Dockerfile

@@ -384,12 +384,12 @@ RUN --mount=from=builder,src=/build/,dst=/mnt/build \
     if [ -f /mnt/build/libopusshim.so ]; then cp /mnt/build/libopusshim.so ./; fi
 
 # Make sure the models directory exists
-RUN mkdir -p /models /backends
+RUN mkdir -p /models /backends /data
 
 # Define the health check command
 HEALTHCHECK --interval=1m --timeout=10m --retries=10 \
   CMD curl -f ${HEALTHCHECK_ENDPOINT} || exit 1
 
-VOLUME /models /backends /configuration
+VOLUME /models /backends /configuration /data
 EXPOSE 8080
 ENTRYPOINT [ "/entrypoint.sh" ]

docker-compose.yaml

@@ -31,6 +31,7 @@ services:
     volumes:
       - models:/models
       - images:/tmp/generated/images/
+      - data:/data
     command:
     # Here we can specify a list of models to run (see quickstart https://localai.io/basics/getting_started/#running-models )
     # or an URL pointing to a YAML configuration file, for example:
@@ -73,4 +74,5 @@ services:
 volumes:
   models:
   images:
+  data:
   # postgres_data:

docs/content/installation/containers.md

@@ -212,29 +212,44 @@ services:
 
 ## Persistent Storage
 
-To persist models and configurations, mount a volume:
+The container exposes the following volumes:
+
+| Volume | Description | CLI Flag | Environment Variable |
+|--------|-------------|----------|----------------------|
+| `/models` | Model files used for inferencing | `--models-path` | `$LOCALAI_MODELS_PATH` |
+| `/backends` | Custom backends for inferencing | `--backends-path` | `$LOCALAI_BACKENDS_PATH` |
+| `/configuration` | Dynamic config files (api_keys.json, external_backends.json, runtime_settings.json) | `--localai-config-dir` | `$LOCALAI_CONFIG_DIR` |
+| `/data` | Persistent data (collections, agent state, tasks, jobs) | `--data-path` | `$LOCALAI_DATA_PATH` |
+
+To persist models and data, mount volumes:
 
 ```bash
 docker run -ti --name local-ai -p 8080:8080 \
   -v $PWD/models:/models \
+  -v $PWD/data:/data \
   localai/localai:latest-aio-cpu
 # Or with Podman:
 podman run -ti --name local-ai -p 8080:8080 \
   -v $PWD/models:/models \
+  -v $PWD/data:/data \
   localai/localai:latest-aio-cpu
 ```
 
-Or use a named volume:
+Or use named volumes:
 
 ```bash
 docker volume create localai-models
+docker volume create localai-data
 docker run -ti --name local-ai -p 8080:8080 \
   -v localai-models:/models \
+  -v localai-data:/data \
   localai/localai:latest-aio-cpu
 # Or with Podman:
 podman volume create localai-models
+podman volume create localai-data
 podman run -ti --name local-ai -p 8080:8080 \
   -v localai-models:/models \
+  -v localai-data:/data \
   localai/localai:latest-aio-cpu
 ```