Ensure uploads directory exists on container startup
Create /a0/usr/uploads during Docker runtime initialization before supervised services start so upload callers can rely on the directory immediately after boot. Document the startup directory contract in docker/run AGENTS instructions.
Alessandro committed
Jun 19, 2026 at 11:57 UTC
684e0b414d3fbfeeb78bfcd2973eb61890acdb52
2 files changed
+4
docker/run/AGENTS.md
+1
@@ -20,6 +20,7 @@
20
- Preserve exposed ports for SSH, HTTP, and tunneled services unless docs and workflows are updated together.
21
- Keep the two-runtime Python model aligned with the root contract.
22
- Do not bake secrets, local `.env` values, or user data into the image.
23
+- Runtime startup must ensure `/a0/usr/uploads` exists before supervised services start.
24
25
## Work Guidance
26
docker/run/fs/exe/initialize.sh
+3
@@ -12,6 +12,9 @@ BRANCH="$1"
12
# Copy all contents from persistent /per to root directory (/) without overwriting
13
cp -r --no-preserve=ownership,mode /per/* /
14
15
+# Ensure upload storage exists before API and connector callers can reference it.
16
+mkdir -p /a0/usr/uploads
17
+
18
# allow execution of /root/.bashrc and /root/.profile
19
chmod 444 /root/.bashrc
20
chmod 444 /root/.profile