From a4a5bb4bbcb3e7e3c81ba1b165961e7956488885 Mon Sep 17 00:00:00 2001 From: Romuald Lemesle Date: Tue, 10 Mar 2026 11:37:54 +0100 Subject: [PATCH 1/2] [docs] feat(installation): add troubleshooting section for Docker Compose deployment --- docs/deployment/installation.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/deployment/installation.md b/docs/deployment/installation.md index 84292df2..5df9b2a7 100644 --- a/docs/deployment/installation.md +++ b/docs/deployment/installation.md @@ -84,6 +84,30 @@ docker compose up -d You can now navigate to [http://localhost:8080](http://localhost:8080/) and log in with the credentials filled in your configuration. +### Troubleshooting + +#### PostgreSQL: password authentication failed + + +This error occurs when the PostgreSQL container cannot authenticate with the credentials provided in your `.env` file. + +**Common causes:** + +| Cause | Solution | +|:------|:---------| +| `POSTGRES_USER` set to a reserved name (e.g. `admin`) | Use a different username (e.g. `openaev`) | +| Mismatch between `POSTGRES_USER`/`POSTGRES_PASSWORD` and `SPRING_DATASOURCE_USERNAME`/`SPRING_DATASOURCE_PASSWORD` | Ensure both sets of credentials match | + +#### Container fails to start + +If the OpenAEV container exits immediately after starting: + +1. Check the logs: `docker compose logs openaev` +2. Verify all required environment variables are set in your `.env` file +3. Ensure all dependency containers (PostgreSQL, ElasticSearch, RabbitMQ, MinIO) are healthy: + ```bash + docker compose ps + ## Manual installation This section provides instructions to install and run a pre-built OpenAEV server with its dependencies. Note that this From 7fffa4eadbb9becda51e226929adb811e72e494e Mon Sep 17 00:00:00 2001 From: Romuald Lemesle Date: Tue, 31 Mar 2026 13:40:22 +0200 Subject: [PATCH 2/2] [docs] feat(installation): add troubleshooting section for Docker Compose deployment --- docs/deployment/installation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/deployment/installation.md b/docs/deployment/installation.md index 5df9b2a7..bfb5deb8 100644 --- a/docs/deployment/installation.md +++ b/docs/deployment/installation.md @@ -107,6 +107,7 @@ If the OpenAEV container exits immediately after starting: 3. Ensure all dependency containers (PostgreSQL, ElasticSearch, RabbitMQ, MinIO) are healthy: ```bash docker compose ps + ``` ## Manual installation