docker-debug

Diagnose Kurtosis engine and API container issues on local Docker.

547|97|Updated Feb 14, 2023

Search Tags:#debugging #logs #networking #docker #kurtosis #engine-status

Ready to run

npx skills add https://github.com/kurtosis-tech/kurtosis --skill docker-debug-kurtosis-tech

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: docker-debug
Source: https://github.com/kurtosis-tech/kurtosis/tree/main/skills/docker-debug
Command: npx skills add https://github.com/kurtosis-tech/kurtosis --skill docker-debug-kurtosis-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug Kurtosis on Docker issues by enabling quick diagnosis of engine status, API containers, and service logs; identify port conflicts and networking problems, so you can restore and verify operations quickly.

Core Features & Use Cases

Engine status checks and health validation
Container log inspection and quick triage of failures
Port, networking, and enclave connectivity verification
Guided remediation steps and safe cleanup commands

Quick Start

Start by verifying the Kurtosis engine is running on Docker and then inspect the API container logs to identify the issue.

Frequently Asked Questions about docker-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I debug Kurtosis engine startup failures on Docker?▼

Debug Kurtosis on Docker by checking the engine status and inspecting API container logs to quickly triage startup failures, identify port conflicts, and apply guided remediation steps to restore operations.

Why is my Kurtosis API container failing to start on a local Docker engine?▼

Your Kurtosis API container may fail due to port conflicts or networking problems across enclaves. Inspect container logs and verify port availability to pinpoint the exact connectivity issue blocking startup.

How do I check Kurtosis engine status and inspect service logs in Docker?▼

Check Kurtosis engine status and inspect service logs by running health validation commands via the Kurtosis CLI on your local Docker engine. This process helps triage failures and identify operational issues across enclaves.

Do I need Docker and Kurtosis CLI to diagnose local engine networking problems?▼

Yes, diagnosing local engine networking problems requires Docker and the Kurtosis CLI. These tools enable you to verify enclave connectivity, check port configurations, and run safe cleanup commands to resolve networking issues.

What is the best way to fix port conflicts when running Kurtosis on Docker?▼

The best way to fix port conflicts when running Kurtosis on Docker is to verify port availability, inspect API container logs, and execute safe cleanup commands to remove conflicting containers and restore enclave connectivity.

How do I safely clean up Kurtosis containers and fix enclave connectivity issues?▼

Safely clean up Kurtosis containers and fix enclave connectivity issues by using guided remediation commands to remove failed API containers, verify networking status, and restore operations on your local Docker engine.

kurtosis-tech

547

docker-local-build

Builds and tests Kurtosis from source on local Docker, compiling Engine, Core, Files Artifacts Expander, CLI, tagging images with git short SHA, and restarting the engine for a clean test environment.

Official

Intermediate