Bootstrap path
`cuda-doctor setup`
setup is the bootstrap path for machines that are not just inconsistent, but largely unprepared for CUDA work.
cuda-doctor setup
v0.0.0Bootstrap, not reconcile
setup is different from doctor auto. It prepares a system that is mostly missing CUDA prerequisites. doctor auto is for reconciling a stack that exists but is broken, misleading, or internally inconsistent.
What setup should cover
- Establish a baseline driver and toolkit path for the detected GPU generation.
- Prepare environment variables and binary paths so the intended toolkit is actually used.
- Install or surface missing runtime prerequisites needed for validation.
- Leave the machine ready for a doctor pass and a real validation run.
Related docs
Repair
doctor auto
Apply compatible repairs to a broken or misleading CUDA environment and refuse success until validation passes.
Execution
validate
Prove that device selection, memory transfer, kernel launch, and runtime behavior work on the local GPU.
Start here
Quickstart
Install cuda-doctor, diagnose the machine, repair what is compatible, then prove GPU execution works.