Install Troubleshooting¶
Troubleshooting should be specific, not vague.
Start Here¶
- identify the failing stage
- rerun the smallest relevant check
- fix the exact failure layer
- avoid restarting the entire setup unless the state is clearly broken
Failure Layers¶
- prerequisite failure
- repo clone failure
- install script failure
- validation failure
- plugin setup failure
- harness setup failure
- auth or permission failure
Fastest Useful Checks¶
sh
git --version
./scripts/validate-repo.sh
./install/verify-install.sh --target ./.orca-framework
./install/doctor.sh --target ./.orca-framework