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] 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!