Skip to main content

Troubleshooting

Common issues and solutions

Common Issues

Connection Refused

If you see connection errors:

Error: failed to connect to backend: connection refused

Solutions:

  1. Verify port-forward is running: kubectl port-forward svc/odin-deployer -n odin 8080:80
  2. Check backend address in config: cat ~/.odin/config
  3. Reconfigure CLI: odin configure --backend-address 127.0.0.1:8080 -I -P

CLI Issues

Command Not Found

odin: command not found

Solution: Add odin to PATH:

sudo mv ~/odin /usr/local/bin/odin
chmod +x /usr/local/bin/odin

Authentication Failed

Solution: Reconfigure with correct credentials:

odin configure --backend-address api.example.com:443 --org-id YOUR_ORG_ID

Deployment Issues

Deployment Stuck in DEPLOYING State

Check pod status:

kubectl get pods -n <namespace>

Check logs:

kubectl logs -n <namespace> <pod-name>

Component Dependencies Not Met

Getting Help

If issues persist:

  1. Check Installation FAQ
  2. Review CLI Reference
  3. Open an issue on GitHub