From feb834fefb82815f5119e965a0e604acf18899bf Mon Sep 17 00:00:00 2001
From: Fitz <44662337+GitHubberFitz@users.noreply.github.com>
Date: Fri, 18 Jul 2025 17:48:58 -0600
Subject: [PATCH 1/2] Update ONBOARDING.md, Included troubleshooting fix for
dependency failures on starting direct-file-db, state-api-db,
email-service-db.
Included troubleshooting fix for dependency failures on starting direct-file-db, state-api-db, email-service-db.
Permissions are not properly being set or falling back to 999:999
---
ONBOARDING.md | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/ONBOARDING.md b/ONBOARDING.md
index 0e61cd5..a046379 100644
--- a/ONBOARDING.md
+++ b/ONBOARDING.md
@@ -335,6 +335,17 @@ Most of the project dependencies can be installed using [SDKMAN!](https://sdkman
docker compose up -d
```
+2. If you have issues starting direct-file-db, state-api-db, and email-service-db, this can be fixed by setting the correct ownership on the data folders
+ 1. This can be confirmed by checking the container logs and seeing the following errors:
+ `chown: cannot read directory '/var/lib/postgresql/data': Permission denied`
+ `chmod: changing permissions of '/var/lib/postgresql/data': Operation not permitted`
+
+ ```sh
+ chown -R 999:999 ./docker/db/postgres
+ chown -R 999:999 ./state-api/docker/db/postgres
+ chown -R 999:999 ./email-service/docker/db/postgres
+ ```
+
#### Resources
That's it!
From e4b40f7399f5406cb9bc24c3c03fcd41277df789 Mon Sep 17 00:00:00 2001
From: Fitz <44662337+GitHubberFitz@users.noreply.github.com>
Date: Fri, 18 Jul 2025 17:59:53 -0600
Subject: [PATCH 2/2] Update ONBOARDING.md, fixed log formatting and code
indentations
Fixed my troubleshooting log formatting in MD
Also under "Stand up development containers" was incorrectly showing the MD code block syntax from being indented
```sh
```
and
```shell
```
---
ONBOARDING.md | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
diff --git a/ONBOARDING.md b/ONBOARDING.md
index a046379..112dbf9 100644
--- a/ONBOARDING.md
+++ b/ONBOARDING.md
@@ -336,9 +336,9 @@ Most of the project dependencies can be installed using [SDKMAN!](https://sdkman
```
2. If you have issues starting direct-file-db, state-api-db, and email-service-db, this can be fixed by setting the correct ownership on the data folders
- 1. This can be confirmed by checking the container logs and seeing the following errors:
- `chown: cannot read directory '/var/lib/postgresql/data': Permission denied`
- `chmod: changing permissions of '/var/lib/postgresql/data': Operation not permitted`
+ 1. This can be confirmed by checking the container logs and seeing the following errors:
+
`chown: cannot read directory '/var/lib/postgresql/data': Permission denied`
+
`chmod: changing permissions of '/var/lib/postgresql/data': Operation not permitted`
```sh
chown -R 999:999 ./docker/db/postgres
@@ -381,15 +381,15 @@ Some quick links:
Use Docker to build database containers and AWS mock services (referred to as "localstack")
- ```sh
- docker compose up -d db mef-apps-db localstack
- ```
+ ```sh
+ docker compose up -d db mef-apps-db localstack
+ ```
The command below will display all running containers and can be used to validate the above command was successful
- ```shell
- docker ps
- ```
+ ```shell
+ docker ps
+ ```
If successful, you should see three images running: localstack, direct-file-mef-apps-db, and direct-file-db.