# `mix local.hex`
[🔗](https://github.com/elixir-lang/elixir/blob/9622c4c67b77a75370022c891d733a082f97454a/lib/mix/lib/mix/tasks/local.hex.ex#L5)

Installs Hex locally.

    $ mix local.hex [version]

By default the latest compatible version of Hex will be installed, unless
`version` is specified.

If installing a precompiled Hex does not work, you can compile and install
Hex directly with this command:

    $ mix archive.install github hexpm/hex branch latest

## Command line options

  * `--force` - forces installation without a shell prompt; primarily
    intended for automation in build systems like `make`

  * `--if-missing` - performs installation only if Hex is not installed yet,
    or if the specified version is different than the installed version.
    This is intended to avoid repeatedly reinstalling Hex in automation
    when a script may be run multiple times

If both options are set, the shell prompt is skipped and Hex is not
re-installed if it was already installed.

## Mirrors

If you want to change the [default mirror](https://builds.hex.pm)
used for fetching Hex, set the `HEX_BUILDS_URL` environment variable.

---

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