Tooling for troubleshooting and maintaining EweserDB Docker Compose stacks.
Install
mkdir -p .claude/skills/eweser-docker-debug && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18871" && unzip -o skill.zip -d .claude/skills/eweser-docker-debug && rm skill.zipInstalls to .claude/skills/eweser-docker-debug
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Use this skill to debug the EweserDB Docker Compose local development stack. Covers service health checks, log inspection, container exec, volume issues, and common failure patterns for auth-api, sync-server, postgres, and caddy.Key capabilities
- →Inspect logs for EweserDB services
- →Check health status of Docker Compose services
- →Execute commands inside Docker containers
- →Restart specific Docker Compose services
- →Reset Docker volumes for services
How it works
The skill uses `docker compose` commands to interact with the EweserDB Docker Compose stack, allowing inspection of logs, service status, and execution of commands within containers.
Inputs & outputs
When to use eweser-docker-debug
- →Fixing local postgres startup issues
- →Inspecting auth-api logs
- →Resetting development database volumes
- →Checking container network status
About this skill
Role: EweserDB Docker Debug
You troubleshoot the EweserDB Docker Compose local development environment.
Services in docker-compose.dev.yml
| Service | Default Port | Purpose |
|---|---|---|
postgres | 5432 | PostgreSQL database |
auth-api | 3001 | Hono auth server |
sync-server | 38181 | Hocuspocus CRDT sync |
caddy | 3000, 443 | Reverse proxy |
aggregator | 38190 | Aggregator service |
Common debug commands
docker compose -f docker-compose.dev.yml up
docker compose -f docker-compose.dev.yml logs -f
docker compose -f docker-compose.dev.yml logs -f auth-api
docker compose -f docker-compose.dev.yml ps
docker compose -f docker-compose.dev.yml exec auth-api sh
docker compose -f docker-compose.dev.yml restart auth-api
Full volume reset destroys local database data:
docker compose -f docker-compose.dev.yml down -v
docker compose -f docker-compose.dev.yml up --build
Common failure patterns
Postgres will not start
- Check whether port 5432 is already in use:
lsof -i :5432. - Check volume permissions. A volume reset destroys local database data.
Auth API crashes on boot
- Missing env vars: compare local env names against
packages/auth-server-hono/example.env. - Database not ready yet: check service health and
depends_onbehavior.
Sync server auth failures
SYNC_AUTH_SECRETmust match between auth-api and sync-server.- JWT tokens may be expired. Re-login to refresh them.
Caddy 502 errors
- Upstream service may not be running. Check
docker compose ps. - Port mismatch. Check
docker/Caddyfileagainst service ports.
Migration not applied
docker compose -f docker-compose.dev.yml exec auth-api npx drizzle-kit migrate
Rebuild after code changes
docker compose -f docker-compose.dev.yml up --build
When not to use it
- →When debugging non-EweserDB Docker Compose environments
- →When needing to preserve local database data during a reset
- →When troubleshooting issues outside of Docker Compose services
Limitations
- →Focuses on EweserDB Docker Compose local development stack
- →Volume reset destroys local database data
- →Troubleshooting is limited to listed services: postgres, auth-api, sync-server, caddy, aggregator
How it compares
This skill provides specific commands and troubleshooting patterns for the EweserDB Docker Compose environment, offering targeted debugging compared to general Docker commands.
Compared to similar skills
eweser-docker-debug side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| eweser-docker-debug (this skill) | 0 | 2mo | Review | Beginner |
| docker-expert | 11 | 6mo | Review | Intermediate |
| deployment-engineer | 4 | 3mo | No flags | Advanced |
| devops | 2 | 6mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
docker-expert
davila7
Docker containerization expert with deep knowledge of multi-stage builds, image optimization, container security, Docker Compose orchestration, and production deployment patterns. Use PROACTIVELY for Dockerfile optimization, container issues, image size problems, security hardening, networking, and orchestration challenges.
deployment-engineer
sickn33
Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.
devops
mrgoonie
Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Kubernetes (kubectl, Helm). Use for serverless, containers, CI/CD, GitOps, security audit.
ecs
itsmostafa
AWS ECS container orchestration for running Docker containers. Use when deploying containerized applications, configuring task definitions, setting up services, managing clusters, or troubleshooting container issues.
add-install-docker-ci-e2e
RLinf
Adds install command in install script, Docker build stage in Dockerfile, and CI jobs for docker build, install script, and embodied e2e test when introducing a new model or environment in RLinf. Use when adding a new embodied model (e.g. dexbotic), new env (e.g. maniskill_libero), or new model+env combination that should be installable, dockerized, and tested in CI.
debug-cluster
openshift
Provides systematic debugging approaches for HyperShift hosted-cluster issues. Auto-applies when debugging cluster problems, investigating stuck deletions, or troubleshooting control plane issues.