Test Recipes Docker and SSH Guidelines

SSH Host Access

• The SSH host is accessible as user "sketch" at host.docker.internal:2222
• Use the provided SSH key at /sketch_test_key
• Connection command: ssh -i /sketch_test_key -p 2222 sketch@host.docker.internal

Docker and gvisor Installation

• The SSH host runs Ubuntu and requires Docker and gvisor to be installed manually
• Use Ubuntu's native docker.io package instead of Docker's official repository
• Install with: sudo apt install -y docker.io docker-compose
• Follow the instructions in README.md for complete installation steps
• Both runc (default) and runsc (gvisor) runtimes should be available
• Test with: docker run --runtime=runsc --rm hello-world

Sketch Testing with Docker over SSH

• Configure SSH config for easy access: Host dockerhost pointing to the VM
• Use DOCKER_HOST=ssh://dockerhost for remote Docker access
• For one-shot testing: DOCKER_HOST=ssh://dockerhost ANTHROPIC_API_KEY="key" go run ./cmd/sketch -one-shot -prompt "prompt" -verbose -unsafe -skaband-addr=""
• The -skaband-addr="" flag bypasses sketch.dev authentication for testing

Container Networking Issues

• When running Docker inside containers, expect networking and iptables permission issues
• Use --iptables=false --bridge=none flags for dockerd in constrained environments
• Consider using host networking or simplified setups for testing

Package Installation

• Always use longer timeouts for package installations (2-5 minutes)
• Ubuntu package installs may show debconf warnings in non-interactive environments - this is normal
• Install SSH client with: apt install -y openssh-client