Troubleshooting¶
CredProxy Network Namespace Architecture¶
Common Issues¶
Port Conflicts¶
# Check port usage
netstat -tulpn | grep 1338
# Change port in configuration
server:
port: 1339
Credential Errors¶
# Check AWS credentials
aws sts get-caller-identity
# Verify environment variables
docker compose exec credproxy env | grep AWS
Network Issues¶
# Check container networking
docker network ls
docker compose ps
# Test connectivity
docker compose exec credproxy curl http://localhost:1338/health
Configuration Errors¶
# Validate configuration
poetry run credproxy --validate-only --config config.yaml
# Check logs
docker compose logs credproxy
Debug Mode¶
Enable debug logging for detailed troubleshooting:
# config.yaml
server:
debug: true
# Or via CLI
poetry run credproxy --dev --log-level DEBUG