trm/docs
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add Docker image facts and Phase 1 scaffold decisions documentation

Browse Source
This commit is contained in:
Julian Çuni
2026-05-01 21:29:39 +02:00
parent 02156208f2
commit 507aa8b23b
4 changed files with 58 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/agent-memory/directus-devops-architect/reference_directus_image.md
+18
View File
@@ -0,0 +1,18 @@
---
name: Directus Docker image facts
description: Key facts about directus/directus:11.17.4 needed when extending or wrapping the image
type: reference
---
# Directus Docker image facts
- **Pinned tag**: `directus/directus:11.17.4` — confirmed to exist on Docker Hub (pushed 2026-04-30).
- **Base image**: `node:22-alpine` (Alpine Linux). Use `apk add` for additional packages.
- **Non-root user**: The upstream image runs as user `node`. Our Dockerfile switches to `USER root` for apk/chmod, then drops back with `USER node`.
- **Working directory**: `/directus`
- **Upstream CMD** (not ENTRYPOINT): `node cli.js bootstrap && pm2-runtime start ecosystem.config.cjs`
- `node cli.js bootstrap` — idempotent DB init + admin user creation from ADMIN_EMAIL/ADMIN_PASSWORD. Safe to run every container start.
- `pm2-runtime start ecosystem.config.cjs` — starts Directus under PM2; handles crash recovery and signal forwarding.
- **Port**: 8055
- **psql client package** on Alpine: `postgresql16-client` (version-specific; no generic `postgresql-client` on Alpine 3.20).
- **Entrypoint override**: Our `entrypoint.sh` must call `node /directus/cli.js bootstrap` then `exec pm2-runtime start /directus/ecosystem.config.cjs` to replicate upstream behavior. Do NOT just call `node /directus/cli.js start` — that skips pm2.