> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainloop.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Installation

You can install the Chainloop CLI using one of the following methods:

<Tabs>
  <Tab title="Installation Script">
    ```bash theme={"dark"}
    curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s
    ```

    <Accordion title="Advanced Options">
      you can install a specific version with

      ```bash theme={"dark"}
      curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s -- --version vx.x.x
      ```

      and customize the install path (default to /usr/local/bin)

      ```bash theme={"dark"}
      curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s -- --path /my-path
      ```

      To install without sudo, provide a user-accessible path:

      ```bash theme={"dark"}
      curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s -- --path ~/.local/bin
      ```

      if [cosign](https://docs.sigstore.dev/quickstart/quickstart-cosign/) is present in your system, in addition to the checksum check, a signature verification will be performed. This behavior can be enforced via the --force-verification flag.

      ```bash theme={"dark"}
      curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s -- --force-verification
      ```

      To install the open-source edition instead:

      ```bash theme={"dark"}
      curl -sfL https://dl.chainloop.dev/cli/install.sh | bash -s -- --oss
      ```
    </Accordion>
  </Tab>

  <Tab title="Manual Download">
    Download the CLI binary directly and verify its SHA256 against the published `checksums.txt`. Use this when piping a script into `bash` is not an option, or when binaries need to be validated out-of-band.

    <AccordionGroup id="cli-versions">
      <Accordion title="v1.76.5" defaultOpen>
        | OS    | Architecture  | Download                                                                                                                                  | SHA256                                                             |
        | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
        | Linux | Intel (amd64) | [chainloop-linux-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.76.5/chainloop-linux-amd64)   | `0b78bc6d840e4c9d2987219af784a211fbf5df2bb84dcc54aad8b61b24f2a3b7` |
        | Linux | ARM64         | [chainloop-linux-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.76.5/chainloop-linux-arm64)   | `075aca72dd9c361ecb3c7689cd93f885f7bb9c0edec0dc7932b32b4e561f8106` |
        | macOS | Intel (amd64) | [chainloop-darwin-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.76.5/chainloop-darwin-amd64) | `7598c591d6a9502a7f1db67d2f66f63f369890f9fc2325f116dd335c053a8a2f` |
        | macOS | Apple Silicon | [chainloop-darwin-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.76.5/chainloop-darwin-arm64) | `efb046ae23dc9e66e4738382a245a2a59a50399d20bae0eb17dab77df35896e2` |

        Full manifest: [`checksums.txt`](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.76.5/checksums.txt) · [Release notes](/changelog)

        Verify with `sha256sum -c checksums.txt` (Linux) or `shasum -a 256 -c checksums.txt` (macOS).
      </Accordion>

      <Accordion title="v1.75.1">
        | OS    | Architecture  | Download                                                                                                                                  | SHA256                                                             |
        | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
        | Linux | Intel (amd64) | [chainloop-linux-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.1/chainloop-linux-amd64)   | `a6a1e4438e3a0f9a66ac471bee85bd4abb70f5d40c2c22e224e44454aa9da372` |
        | Linux | ARM64         | [chainloop-linux-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.1/chainloop-linux-arm64)   | `82a121782f63f0560447b120670a1da55cda27d158eae8c758242bce0ff7bb46` |
        | macOS | Intel (amd64) | [chainloop-darwin-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.1/chainloop-darwin-amd64) | `161ee05bfc118b3f02227f5a07ff0590941d3dbc79a75ef816cab2add0846570` |
        | macOS | Apple Silicon | [chainloop-darwin-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.1/chainloop-darwin-arm64) | `be5243ad906f14f7a24152b1dd03d4ffc467906858ebe6a0efcf90250f36f8f9` |

        Full manifest: [`checksums.txt`](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.1/checksums.txt) · [Release notes](/changelog)

        Verify with `sha256sum -c checksums.txt` (Linux) or `shasum -a 256 -c checksums.txt` (macOS).
      </Accordion>

      <Accordion title="v1.75.0">
        | OS    | Architecture  | Download                                                                                                                                  | SHA256                                                             |
        | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
        | Linux | Intel (amd64) | [chainloop-linux-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.0/chainloop-linux-amd64)   | `c985fd3213a758257e22fa062bd1b4c32c28dc13d4c9061e9992a40f7f685b9a` |
        | Linux | ARM64         | [chainloop-linux-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.0/chainloop-linux-arm64)   | `0f570b3e9762c52ceb76f880403d236e917fac7a598621a4debf3418a9440a51` |
        | macOS | Intel (amd64) | [chainloop-darwin-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.0/chainloop-darwin-amd64) | `120cb395a3a9f1aead9ee3c9b45e9d083da60afacc752f8918ed93f523b70a4d` |
        | macOS | Apple Silicon | [chainloop-darwin-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.0/chainloop-darwin-arm64) | `fb179668461887e87fc1be3fbd32f3241bc1975c1b3188880d4ae6020ebffdad` |

        Full manifest: [`checksums.txt`](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.75.0/checksums.txt) · [Release notes](/changelog)

        Verify with `sha256sum -c checksums.txt` (Linux) or `shasum -a 256 -c checksums.txt` (macOS).
      </Accordion>

      <Accordion title="v1.74.1">
        | OS    | Architecture  | Download                                                                                                                                  | SHA256                                                             |
        | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
        | Linux | Intel (amd64) | [chainloop-linux-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.1/chainloop-linux-amd64)   | `4019d9d5b18c4f2cf67f8300f64a27eeeecff04acca9af5892d89007600d351d` |
        | Linux | ARM64         | [chainloop-linux-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.1/chainloop-linux-arm64)   | `826bf90f9922b9d5db41fb9dab8ee40f0dc09969b44b62a61e7bee2fde0db734` |
        | macOS | Intel (amd64) | [chainloop-darwin-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.1/chainloop-darwin-amd64) | `ce4545fb993dc295c8cd5d26f85ad3032dc25bfe9c68267b5cf66db1d4774796` |
        | macOS | Apple Silicon | [chainloop-darwin-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.1/chainloop-darwin-arm64) | `7e337bde4e79c004b3c9c5e9cd0200bee924105c199050c96fabc2fb28198477` |

        Full manifest: [`checksums.txt`](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.1/checksums.txt) · [Release notes](/changelog)

        Verify with `sha256sum -c checksums.txt` (Linux) or `shasum -a 256 -c checksums.txt` (macOS).
      </Accordion>

      <Accordion title="v1.74.0">
        | OS    | Architecture  | Download                                                                                                                                  | SHA256                                                             |
        | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
        | Linux | Intel (amd64) | [chainloop-linux-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.0/chainloop-linux-amd64)   | `5f3890418f9622a49493dc372bdc42397ba00cb3ed05c2dddcea2f861fbe62b3` |
        | Linux | ARM64         | [chainloop-linux-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.0/chainloop-linux-arm64)   | `cb1a73b3ddafe5889dbcc3115097cb53f7db520409bae4b231b4816be413a9b5` |
        | macOS | Intel (amd64) | [chainloop-darwin-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.0/chainloop-darwin-amd64) | `3bfe953139112d2c843600a4703bc65d5ac14f835808cacb83b6d2c59b0ef9e4` |
        | macOS | Apple Silicon | [chainloop-darwin-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.0/chainloop-darwin-arm64) | `e0c6c15185a2dffecb5bc00bc8feefb4d016c2b2144c6f3a91b711692ab0f4d5` |

        Full manifest: [`checksums.txt`](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.74.0/checksums.txt) · [Release notes](/changelog)

        Verify with `sha256sum -c checksums.txt` (Linux) or `shasum -a 256 -c checksums.txt` (macOS).
      </Accordion>

      <Accordion title="v1.73.2">
        | OS    | Architecture  | Download                                                                                                                                  | SHA256                                                             |
        | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
        | Linux | Intel (amd64) | [chainloop-linux-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.2/chainloop-linux-amd64)   | `88c008610950ba302545e9ec24008650a948247d497e7228768d48737a9d4ad7` |
        | Linux | ARM64         | [chainloop-linux-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.2/chainloop-linux-arm64)   | `f104aeb87df948400db9cd3e095b556d50d8c64b772962241e15c269cce1ba91` |
        | macOS | Intel (amd64) | [chainloop-darwin-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.2/chainloop-darwin-amd64) | `9012689011e55054d4249150e8d0ea48f5816e15603f20efcc76c4f0feca8375` |
        | macOS | Apple Silicon | [chainloop-darwin-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.2/chainloop-darwin-arm64) | `8ba3bd56af8c7b5c5bfd29500f12965c7da28bd8b1d549b81f90217146d57f89` |

        Full manifest: [`checksums.txt`](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.2/checksums.txt) · [Release notes](/changelog)

        Verify with `sha256sum -c checksums.txt` (Linux) or `shasum -a 256 -c checksums.txt` (macOS).
      </Accordion>

      <Accordion title="v1.73.1">
        | OS    | Architecture  | Download                                                                                                                                  | SHA256                                                             |
        | ----- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
        | Linux | Intel (amd64) | [chainloop-linux-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.1/chainloop-linux-amd64)   | `7dea4b8e87a820a7b41a6e06a83302efb9398389a10b5e45fec63388779ed8aa` |
        | Linux | ARM64         | [chainloop-linux-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.1/chainloop-linux-arm64)   | `9d8e0dfadcf7ae9b92f83141e681b5b3fa2d394436299b5aed698bf753995fa7` |
        | macOS | Intel (amd64) | [chainloop-darwin-amd64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.1/chainloop-darwin-amd64) | `1a0cf6f3322db9e54fd41cddbde2156577bbc33602e488e40384b0e0bd16f69d` |
        | macOS | Apple Silicon | [chainloop-darwin-arm64](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.1/chainloop-darwin-arm64) | `ed909640031769226328f76ac955d772b3ca39967db7c8c3c73dd806372ea91b` |

        Full manifest: [`checksums.txt`](https://chainloop-baafegchfnekdcde.z02.azurefd.net/public/chainloop-platform-cli/v1.73.1/checksums.txt) · [Release notes](/changelog)

        Verify with `sha256sum -c checksums.txt` (Linux) or `shasum -a 256 -c checksums.txt` (macOS).
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

## On-Premises CLI Configuration (if applicable)

If you are running your own instance of Chainloop Platform. You must change the default endpoints' values pointing by using the following command:

```bash theme={"dark"}
chainloop config save \
  --control-plane my-controlplane.acme.com:443 \
  --artifact-cas cas.acme.com:443 \
  --platform my-platform.acme.com:443
```