digirati-co-uk/madoc-docker-ops
.agents/skills/madoc-docker-ops/SKILL.md
Build, run, and debug the Madoc Docker/compose stack with the Docker daemon already running, including rebuilding images, starting/stopping services, inspecting containers/images, and using pm2 inside the madoc-ts container (server/queue/scheduler/auth) plus frontend rebuilds for volume-mounted assets.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform madoc-docker-opsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:56 PM1.8s1 file scanned
SKILL.md
- name:
- madoc-docker-ops
- description:
- Build, run, and debug the Madoc Docker/compose stack with the Docker daemon already running, including rebuilding images, starting/stopping services, inspecting containers/images, and using pm2 inside the madoc-ts container (server/queue/scheduler/auth) plus frontend rebuilds for volume-mounted assets.
Madoc Docker Ops
Overview
Operate the local Madoc Docker Compose stack, rebuild images when code changes, inspect running containers/images, and use pm2 inside madoc-ts to debug processes and logs.
Compose Map (docker-compose.yml)
Services you will interact with most often:
gatewaymadoc-tsmadoc-ts-viteshared-postgresgateway-redistasks-apimodel-apiconfig-servicestorage-apisearchokra
Also check docker-compose.test.yml when dealing with test-only services or overrides.
Quick Start
- Start the full stack:
docker compose up -d. - Verify health:
docker compose psanddocker compose logs -f madoc-ts. - If only a subset is needed, bring up specific services:
docker compose up -d madoc-ts madoc-ts-vite shared-postgres gateway.
Build & Rebuild Images (Volume-Mounted)
- Rebuild development frontend bundle:
pnpm build:vite-serverrun outside of docker since its a volume - Rebuild selected services:
docker compose build madoc-ts madoc-ts-vite. - Force a clean rebuild:
docker compose build --no-cache madoc-ts. - Rebuild and restart in one step:
docker compose up -d --build madoc-ts.
Frontend Rebuild
The frontend assets are bind-mounted, so rebuilds must be triggered even when containers are already running. However there is a vite server so during development frontend ONLY fixes should be fine.
madoc-ts-vite keeps its image-baked package.json, pnpm-lock.yaml, and node_modules aligned on purpose. After dependency changes, rebuild the madoc-ts-vite image instead of relying on bind-mounted manifest files.
- Rebuild production frontend bundle:
docker compose exec madoc-ts pnpm run build:frontend. - Rebuild server-side bundles:
docker compose exec madoc-ts pnpm run build:vite. - Vite dev server is provided by
madoc-ts-vite(ports 3088/3089); restart it if needed:docker compose restart madoc-ts-vite.
Container & Image Inspection
- List running containers:
docker ps. - List compose containers:
docker compose ps. - List images:
docker imagesordocker compose images. - Inspect a container:
docker inspect <container>. - Check mounted volumes:
docker inspect <container> | rg -n "Mounts".
Logs & Debugging
- Follow logs for a service:
docker compose logs -f madoc-ts. - Last 200 lines:
docker compose logs --tail=200 madoc-ts. - Single container logs:
docker logs -f <container>.
PM2 Inside madoc-ts
madoc-ts runs pnpm dev, which launches pm2 with ecosystem.config.cjs.
Processes: server, queue, scheduler, auth.
Common commands:
- Status:
docker compose exec madoc-ts pm2 status. - Logs:
docker compose exec madoc-ts pm2 logs. - Logs for one app:
docker compose exec madoc-ts pm2 logs server. - Restart a process:
docker compose exec madoc-ts pm2 restart server. - Reload all:
docker compose exec madoc-ts pm2 reload all.
Stop / Clean Up
- Stop everything:
docker compose down. - Stop and remove volumes:
docker compose down -v. - Remove unused images:
docker image prune.
Troubleshooting Checks
- Confirm Docker daemon is reachable:
docker info. - Verify env-driven ports and settings in
docker-compose.yml. - If pm2 is unresponsive, restart the service:
docker compose restart madoc-ts. - If frontend updates do not appear, rerun
pnpm run build:frontendinside the container. - If you want to check if the server is working, here's a quick command you can use:
curl -sk https://madoc.local/ | grep "Something went wrong."
Related Skills
digirati-co-uk/utility-core
tools
VerifiedTrustedCommunity
Work on Madoc TS shared utility helpers (JWT, metadata, errors, IIIF helpers, auth helpers). Use when changing core utility functions or shared helpers in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/types-schemas
development
VerifiedTrustedCommunity
Work on Madoc TS shared type definitions and schema contracts. Use when updating TypeScript types, JSON schema shapes, or cross-layer data contracts in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/tasks-automation
tools
VerifiedTrustedCommunity
Understand and extend Madoc TS task automation, including bots and task-related extensions. Use when adding task automation, bot behavior, or task metadata resolution in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/ssr-site
development
VerifiedTrustedCommunity
Work on Madoc TS site SSR pipeline, HTML template injection, and site render data wiring. Use when changing site SSR behavior, template tokens, or site SSR data wiring in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026