Troubleshooting
Debug common deployment and inference issues.
Deployment failures
Run `upbox logs --deployment <id>` to see build and startup logs. Common issues: missing dependencies, incorrect model format, or memory limits.
High latency
Check if you're hitting cold starts with `upbox metrics latency --breakdown`. Enable always-on mode or increase min replicas for consistent performance.
Out of memory errors
Increase instance memory with `upbox config set resources.memory 16Gi` or optimize your model with quantization to reduce memory footprint.
Model loading errors
Ensure your model file is in a supported format. Run `upbox validate ./model.pt` locally to check compatibility before deploying.
Connection timeouts
Check your network configuration and firewall rules. For VPC deployments, ensure the Upbox endpoint is reachable from your application.
CLI diagnostics
Run `upbox doctor` to check CLI version, authentication status, and connectivity to Upbox services.