Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

docs(self-hosting): document Docker log retention (#16363)

Bexultan3a3f190ddff9
diff --git a/README.md b/README.md
index aa96cd8158..3c4ad5773b 100644
--- a/README.md
+++ b/README.md
@@ -122,6 +122,12 @@ Run Langfuse on your own infrastructure:
See [self-hosting documentation](https://langfuse.com/self-hosting) to learn more about architecture and configuration options.
+#### Docker log rotation
+
+The default `docker-compose.yml` inherits the [Docker daemon's logging configuration](https://docs.docker.com/engine/logging/configure/). Docker's default `json-file` driver does not rotate logs unless configured, which can exhaust disk space. Set its [`max-size` and `max-file` options](https://docs.docker.com/engine/logging/drivers/json-file/), or keep your chosen logging backend and configure retention there. Do not rotate or truncate Docker-managed JSON log files with external tools.
+
+After changing daemon logging defaults, restart Docker and recreate existing containers to apply them; restarting containers alone is insufficient. Plan for interruption and preserve data volumes. These settings cover container stdout/stderr, not database data volumes or ClickHouse's internal log files.
+
> [!TIP]
> **Self-hosting Langfuse?** Subscribe to the [self-hosting update list](https://langfuse.com/self-hosting#subscribe) to get an email about important features and new releases for open source Langfuse — self-hosting updates only, no marketing.