# `mix cauldron_gpu.setup`
[🔗](https://github.com/jaman/cauldron/blob/v0.3.3/cauldron_gpu/lib/mix/tasks/cauldron_gpu.setup.ex#L1)

Finds what building `cauldron_gpu`'s renderer needs on this machine, installs what is
missing when you agree, builds the renderer, and checks that it opens.

    mix cauldron_gpu.setup
    mix cauldron_gpu.setup --check
    mix cauldron_gpu.setup --software

Each missing piece is offered as an automatic install, showing what it will run, or as
steps to follow yourself. Declining leaves games drawing in software, and running the
task again starts over. The paths found are written to the build configuration
(`CauldronGPU.Setup`), so later builds use them without environment variables.

Options:

  * `--check`: report what is found and change nothing
  * `--yes`: accept every automatic install and the build
  * `--software`: build no renderer; games draw in software

---

*Consult [api-reference.md](api-reference.md) for complete listing*