How do I install the Docker Up skill?

Run npx skillmds@latest add tomevault-io/docker-up in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Docker Up safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Docker Up?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Docker Up free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Docker Up?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Docker Up by tomevault-io — Agent Skill

Name: Docker Up
Author: tomevault-io

File contents

Docker Environment Management

Start and manage the application in Docker with SQLite database.

Quick Start

Start in foreground (with logs)

make docker-up

Start in background (detached)

make docker-up-d

View logs

make docker-logs

Stop containers

make docker-down

What Gets Started

Application: Go web service on configured port (default: 8080)
Database: SQLite at ./data/budget.db (persisted in Docker volume)
Health check: Automatic container health monitoring via /health endpoint
Auto-migrations: Database schema applied on startup

Docker Image Details

Base: Alpine Linux (~50MB total size)
Platform: Multi-arch (linux/amd64, linux/arm64)
Registry: GitHub Container Registry
Security: Trivy vulnerability scanning enabled

Environment Configuration

Create .env file in project root to override defaults:

SERVER_PORT=8080
SERVER_HOST=0.0.0.0
DATABASE_PATH=/data/budget.db
SESSION_SECRET=your-secret-key-here
LOG_LEVEL=info
ENVIRONMENT=production

Data Persistence

Database is persisted in Docker volume at ./data/:

Development: ./data/budget.db
Backups: ./backups/ directory

Data survives container restarts and rebuilds.

Common Tasks

Rebuild after code changes

make docker-build
make docker-up

Check container status

docker ps

Execute command in container

docker exec -it family-budget-service sh

View container logs (live)

make docker-logs -f

Health Checks

The container includes automatic health monitoring:

Endpoint: /health
Interval: 30 seconds
Timeout: 10 seconds
Retries: 3

Check health status:

curl http://localhost:8080/health

Expected response:

{"status":"healthy","timestamp":"2026-01-30T10:45:00Z"}

Troubleshooting

Container won't start

Check logs: make docker-logs
Verify port not in use: lsof -i :8080
Check Docker daemon: docker info

Database issues

Verify volume exists: docker volume ls
Check permissions: ls -la ./data/
Restore from backup: /db-backup

Build failures

Clean old images: docker system prune
Rebuild: make docker-build
Check disk space: df -h

---name: docker-updescription: Start the application in Docker with SQLite database Use when this capability is needed.---# Docker Environment ManagementStart and manage the application in Docker with SQLite database.## Quick Start### Start in foreground (with logs)```bashmake docker-up```### Start in background (detached)```bashmake docker-up-d```### View logs```bashmake docker-logs```### Stop containers```bashmake docker-down```## What Gets Started- **Application**: Go web service on configured port (default: 8080)- **Database**: SQLite at `./data/budget.db` (persisted in Docker volume)- **Health check**: Automatic container health monitoring via `/health` endpoint- **Auto-migrations**: Database schema applied on startup## Docker Image Details- **Base**: Alpine Linux (~50MB total size)- **Platform**: Multi-arch (linux/amd64, linux/arm64)- **Registry**: GitHub Container Registry- **Security**: Trivy vulnerability scanning enabled## Environment ConfigurationCreate `.env` file in project root to override defaults:```bashSERVER_PORT=8080SERVER_HOST=0.0.0.0DATABASE_PATH=/data/budget.dbSESSION_SECRET=your-secret-key-hereLOG_LEVEL=infoENVIRONMENT=production```## Data PersistenceDatabase is persisted in Docker volume at `./data/`:- **Development**: `./data/budget.db`- **Backups**: `./backups/` directoryData survives container restarts and rebuilds.## Common Tasks### Rebuild after code changes```bashmake docker-buildmake docker-up```### Check container status```bashdocker ps```### Execute command in container```bashdocker exec -it family-budget-service sh```### View container logs (live)```bashmake docker-logs -f```## Health ChecksThe container includes automatic health monitoring:- **Endpoint**: `/health`- **Interval**: 30 seconds- **Timeout**: 10 seconds- **Retries**: 3Check health status:```bashcurl http://localhost:8080/health```Expected response:```json{"status":"healthy","timestamp":"2026-01-30T10:45:00Z"}```## Troubleshooting### Container won't start1. Check logs: `make docker-logs`2. Verify port not in use: `lsof -i :8080`3. Check Docker daemon: `docker info`### Database issues1. Verify volume exists: `docker volume ls`2. Check permissions: `ls -la ./data/`3. Restore from backup: `/db-backup`### Build failures1. Clean old images: `docker system prune`2. Rebuild: `make docker-build`3. Check disk space: `df -h`## See Also- `make run-local` - Run without Docker for development- `make docker-build` - Build Docker image only- `/db-backup` - Backup database before Docker operations---> Source: [lllypuk/Family-Finances-Service](https://github.com/lllypuk/Family-Finances-Service) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions

Docker Up