> ## 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.

# Setup

## Get access to Chainloop

This guide assumes that you have access to a [Chainloop Cloud](https://app.chainloop.dev/) account or to your own Chainloop instance of Chainloop. If you don't, please [contact us](https://app.chainloop.dev/request-access), and we'll get back to you shortly.

## Install the Chainloop Command Line Interface (CLI)

The Chainloop CLI is used to send pieces of evidence and attestations to the platform. During this getting started, we’ll use the CLI to perform local attestations first but later in a CI/CD system.

To install the latest version for macOS, Linux or Windows (using [WSL](https://learn.microsoft.com/en-us/windows/wsl/install)) just choose one of the following installation method.

<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
```