Skip to content

Troubleshooting

Having problems? This section helps you diagnose and resolve common issues with DataKit.

Quick Help

🔧 Common Issues

Solutions for frequently encountered problems.

View Common Issues →

❓ FAQ

Answers to frequently asked questions.

Browse FAQ →

Getting Help

If you can't find a solution here:

  1. Search existing issues: GitHub Issues
  2. Check the logs: Run commands with --log-level debug
  3. Validate your setup: Run dk version and dk dev status
  4. Open a new issue: Include error messages and environment details

Quick Diagnostics

Run these commands to gather diagnostic information:

# Check DK CLI version
dk version

# Verify Docker is running
docker info

# Check local dev stack status
dk dev status

# Validate a package
dk lint ./my-package

# Run with debug logging
dk --log-level debug run ./my-package

Common Error Categories

Category Description Where to Look
Installation CLI won't install or run Common Issues
Docker Container problems Common Issues
Validation Lint or schema errors Common Issues
Publishing Registry or auth issues Common Issues
Runtime Pipeline execution failures Common Issues

Reporting Bugs

When reporting a bug, please include:

  • DK CLI version (dk version)
  • Operating system and version
  • Docker version (docker version)
  • Complete error message
  • Steps to reproduce
  • Relevant configuration files (with secrets redacted)