This documentation is for not yet released version of imgpkg. For the documentation of the latest release version, see the latest version.

Install

Via script (macOS or Linux) ¶

(Note that install.sh script installs other Carvel tools as well.)

Install binaries into specific directory:

$ mkdir local-bin/
$ curl -L https://carvel.dev/install.sh | K14SIO_INSTALL_BIN_DIR=local-bin bash

$ export PATH=$PWD/local-bin/:$PATH
$ imgpkg version

Or system wide:

$ wget -O- https://carvel.dev/install.sh > install.sh

# Inspect install.sh before running...
$ sudo bash install.sh
$ imgpkg version

Via Homebrew (macOS or Linux) ¶

Based on github.com/carvel-dev/homebrew.

$ brew tap carvel-dev/carvel
$ brew install imgpkg
$ imgpkg version

Specific version from a GitHub release ¶

To download, click on one of the assets in a chosen GitHub release, for example for ‘imgpkg-darwin-amd64’.

# **Compare binary checksum** against what's specified in the release notes
# (if checksums do not match, binary was not successfully downloaded)
$ shasum -a 256 ~/Downloads/imgpkg-darwin-amd64
08b25d21675fdc77d4281c9bb74b5b36710cc091f30552830604459512f5744c  /Users/pivotal/Downloads/imgpkg-darwin-amd64

# Move binary next to your other executables
$ mv ~/Downloads/imgpkg-darwin-amd64 /usr/local/bin/imgpkg

# Make binary executable
$ chmod +x /usr/local/bin/imgpkg

# Check its version
$ imgpkg version

(Help improve our docs: edit this page on GitHub)