Stack Ops

What This Skill Covers

Docker Compose lifecycle operations for the Trinity AGI stack running from src/docker-compose.yml.

Start Stack

docker compose -f src/docker-compose.yml up -d

Check service status after starting.

Stop Stack

docker compose -f src/docker-compose.yml down

View Logs

All services:

docker compose -f src/docker-compose.yml logs --tail 50

Single service (e.g. OpenClaw gateway):

docker compose -f src/docker-compose.yml logs openclaw-gateway --tail 100

Summarize errors, warnings, or notable events. If there are connection issues or crash loops, suggest fixes.

Rebuild Frontend Only

When Flutter/Dart source changes need to be deployed without touching backend services.

CRITICAL: run --rm frontend-builder alone does NOT rebuild the image — it reuses the cached one. You MUST build --no-cache first.

# 1. Rebuild Docker image (busts layer cache — REQUIRED for source changes)
docker compose -f src/docker-compose.yml --profile build build --no-cache frontend-builder

# 2. Run builder to copy build output to the volume
docker compose -f src/docker-compose.yml --profile build run --rm frontend-builder

# 3. Restart nginx to serve the new build
docker restart trinity-nginx

Remind the user to hard-refresh the browser (Ctrl+Shift+R).

Full Deploy

Complete rebuild of frontend + backend after source changes across multiple services.

# 1. Rebuild frontend image (--no-cache)
docker compose -f src/docker-compose.yml --profile build build --no-cache frontend-builder

# 2. Copy frontend build to volume
docker compose -f src/docker-compose.yml --profile build run --rm frontend-builder

# 3. Rebuild backend services (--no-cache)
docker compose -f src/docker-compose.yml build --no-cache terminal-proxy auth-service

# 4. Restart backend services
docker compose -f src/docker-compose.yml up -d terminal-proxy auth-service

# 5. Restart nginx
docker restart trinity-nginx

# 6. Update AGENTS.md in gateway container
docker cp src/AGENTS.md trinity-openclaw:/home/node/.openclaw/workspace/AGENTS.md

# 7. Check service health
docker compose -f src/docker-compose.yml ps --format "table {{.Name}}\t{{.Status}}"

Remind user to Ctrl+Shift+R in the browser.

Service Health Check

docker compose -f src/docker-compose.yml ps --format "table {{.Name}}\t{{.Status}}"

Quick Reference

Source: theredbluepill/trinity — distributed by TomeVault.