Skip to content

docker-commands.md

Latest commit

 

History

History
332 lines (226 loc) · 5 KB

docker-commands.md

File metadata and controls

332 lines (226 loc) · 5 KB
title Docker Commands Reference
description Docker and docker-compose commands for VisionClaw deployment
category reference
difficulty-level intermediate
tags
cli
docker
deployment
updated-date 2025-01-29

Docker Commands Reference

Docker and docker-compose commands for VisionClaw deployment and management.

Docker Compose Commands

Start Services

# Start all services in background
docker-compose up -d

# Start specific service
docker-compose up -d visionclaw

# Start with build
docker-compose up -d --build

# Start with Solid sidecar
docker-compose -f docker-compose.yml -f docker-compose.solid.yml up -d

Stop Services

# Stop all services
docker-compose down

# Stop and remove volumes
docker-compose down -v

# Stop specific service
docker-compose stop visionclaw

Logs

# View all logs
docker-compose logs

# Follow logs
docker-compose logs -f

# Follow specific service logs
docker-compose logs -f visionclaw

# Show last N lines
docker-compose logs --tail=100 visionclaw

Status

# List running containers
docker-compose ps

# List all containers (including stopped)
docker-compose ps -a

Build Commands

Build Images

# Build all images
docker-compose build

# Build with no cache
docker-compose build --no-cache

# Build specific service
docker-compose build visionclaw

# Build with build args
docker-compose build --build-arg VERSION=1.0.0

Push Images

# Push to registry
docker-compose push

# Push specific service
docker-compose push visionclaw

Container Management

Execute Commands

# Execute command in running container
docker-compose exec visionclaw /bin/bash

# Execute as root
docker-compose exec -u root visionclaw /bin/bash

# Run one-off command
docker-compose run --rm visionclaw cargo test

Resource Usage

# View resource usage
docker stats

# View specific container
docker stats visionclaw_visionclaw_1

Inspect

# Inspect container
docker inspect visionclaw_visionclaw_1

# View container IP
docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' visionclaw_visionclaw_1

Volume Management

List Volumes

# List all volumes
docker volume ls

# List project volumes
docker volume ls | grep visionclaw

Inspect Volumes

# Inspect volume
docker volume inspect visionclaw_postgres_data

Remove Volumes

# Remove unused volumes
docker volume prune

# Remove specific volume
docker volume rm visionclaw_postgres_data

Network Management

List Networks

# List networks
docker network ls

# Inspect network
docker network inspect visionclaw_default

Debug Connectivity

# Test connectivity from container
docker-compose exec visionclaw nc -zv postgres 5432

# Check DNS resolution
docker-compose exec visionclaw nslookup postgres

Cleanup Commands

Remove Containers

# Remove stopped containers
docker container prune

# Remove all project containers
docker-compose rm -f

Remove Images

# Remove unused images
docker image prune

# Remove all unused images
docker image prune -a

Full Cleanup

# Remove everything unused
docker system prune

# Remove everything including volumes
docker system prune --volumes -a

Health Checks

Check Container Health

# View health status
docker-compose ps

# Inspect health
docker inspect --format='{{.State.Health.Status}}' visionclaw_visionclaw_1

# View health logs
docker inspect --format='{{json .State.Health}}' visionclaw_visionclaw_1 | jq

Manual Health Check

# Check API health
docker-compose exec visionclaw curl http://localhost:9090/api/health

# Check database
docker-compose exec postgres pg_isready

# Check Redis
docker-compose exec redis redis-cli ping

Environment Configuration

Environment Variables

# Start with env file
docker-compose --env-file .env.production up -d

# Override environment variable
MEMORY_LIMIT=32g docker-compose up -d

Profiles

# Start with profile
docker-compose --profile gpu up -d

# Start with multiple profiles
docker-compose --profile gpu --profile monitoring up -d

Troubleshooting

View Logs

# All service logs since container start
docker-compose logs

# Last 100 lines with timestamps
docker-compose logs -f --tail=100 --timestamps

# Filter by time
docker-compose logs --since 1h

Restart Services

# Restart all
docker-compose restart

# Restart specific service
docker-compose restart visionclaw

# Force recreate
docker-compose up -d --force-recreate

Debug Mode

# Run with debug logging
RUST_LOG=debug docker-compose up

# Run interactively
docker-compose run --rm visionclaw /bin/bash

Related Documentation