f4829178b3
Following some common developer style guides such as Google https://developers.google.com/style/capitalization#capitalization-in-titles-and-headings and Microsoft https://docs.microsoft.com/en-us/style-guide/scannable-content/headings#formatting-headings
2.8 KiB
| title | description | cascade | menu | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Install the Pinniped command-line tool | Download and set up the `pinniped` command-line tool on macOS, Linux, or Windows clients. |
|
|
The pinniped command-line tool is used to generate Pinniped-compatible kubeconfig files, and is also an important part of the Pinniped-based login flow.
It must be installed by administrators setting up a Pinniped cluster as well as by users accessing a Pinniped-enabled cluster.
Install using Homebrew on macOS or Linux
Use Homebrew to install from the Pinniped tap:
brew install vmware-tanzu/pinniped/pinniped-cli
Download binaries
Find the appropriate binary for your platform from the latest release:
{{< buttonlink href="https://get.pinniped.dev/latest/pinniped-cli-darwin-amd64" >}}Download for macOS/amd64{{< buttonicon "download.png" >}}{{< /buttonlink >}}
{{< buttonlink href="https://get.pinniped.dev/latest/pinniped-cli-linux-amd64" >}}Download for Linux/amd64{{< buttonicon "download.png" >}}{{< /buttonlink >}}
{{< buttonlink href="https://get.pinniped.dev/latest/pinniped-cli-windows-amd64.exe" >}}Download for Windows/amd64{{< buttonicon "download.png" >}}{{< /buttonlink >}}
You should put the command-line tool somewhere on your $PATH, such as /usr/local/bin on macOS/Linux.
You'll also need to mark the file as executable.
To find specific versions or view all available platforms and architectures, visit the releases page.
Gatekeeper
If you are using macOS, you may get an error dialog when you first run pinniped that says “pinniped” cannot be opened because the developer cannot be verified.
Cancel this dialog, open System Preferences, click Security & Privacy, and click the Allow Anyway button next to the Pinniped message.
Run the command again and another dialog appears saying macOS cannot verify the developer of “pinniped”. Are you sure you want to open it?.
Click Open to allow the command to proceed.
Install a specific version via script
Choose your preferred release version number and use it to replace the version number in the URL below.
For example, to install v0.9.2 on Linux/amd64:
curl -Lso pinniped https://get.pinniped.dev/v0.9.2/pinniped-cli-linux-amd64 \
&& chmod +x pinniped \
&& sudo mv pinniped /usr/local/bin/pinniped
Replace v0.9.2 with your preferred version number.
Next steps
Next, [install the Supervisor]({{< ref "install-supervisor.md" >}}) and/or [install the Concierge]({{< ref "install-concierge.md" >}})!