Skip to main content

Pomerium's Command Line Interface

Pomerium CLI is an optional command-line client that works as an authentication helper for tools like kubectl and TCP-based applications.

  • Supported Operating Systems: linux, darwin, windows, freebsd
  • Supported Architectures: amd64, arm64, armv6, armv7

Binaries​

You can find official binaries on our GitHub Releases page.

ARCH=[your arch]
OS=[your os]
VERSION=[desired version]
curl -L https://github.com/pomerium/cli/releases/download/${VERSION}/pomerium-cli-${OS}-${ARCH}.tar.gz \
    | tar -z -x

Packages​

Supported formats include rpm and deb.

You can find official packages on our GitHub Releases page or from Cloudsmith.

/etc/yum.repos.d/pomerium-cli.repo
[pomerium-pomerium]
name=pomerium-pomerium
baseurl=https://dl.cloudsmith.io/public/pomerium/pomerium/rpm/el/$releasever/$basearch
repo_gpgcheck=1
enabled=1
gpgkey=https://dl.cloudsmith.io/public/pomerium/pomerium/gpg.6E388440B94E1407.key
gpgcheck=1
sslverify=1
pkg_gpgcheck=1

Homebrew​

brew tap pomerium/tap
brew install pomerium-cli

Docker Image​

Pomerium CLI uses a minimal Docker container. You can find the CLI image on Docker Hub, and pull it in several flavors and architectures. Refer to the example commands below to pull specific versions of Pomerium CLI.

  • The :vX.Y.Z tag pulls a specific tagged release.

    docker run cr.pomerium.com/pomerium/cli:v0.1.0 --version
    v0.1.0+53bfa4e

  • The :latest tag pulls the most recent tagged release.

    docker run cr.pomerium.com/pomerium/cli:latest --version
    v0.2.0+87e214b

  • The :main tag pulls an image in sync with git's main branch.

    docker pull cr.pomerium.com/pomerium/cli:main

Source​

git clone git@github.com:pomerium/cli.git
cd pomerium
make build
./bin/pomerium-cli --help