Skip to main content

Pomerium's Command Line Interface

pomerium-cli (optional, Pomerium is clientless for HTTP based protocols) is a command-line client for working with Pomerium. Functions include acting as an authentication helper for tools like kubectl or TCP based applications.

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

Binaries​

Official binaries can be found 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: rpm, deb

Official packages can be found 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
curl -1sLf 'https://dl.cloudsmith.io/public/pomerium/pomerium/gpg.6E388440B94E1407.key' | apt-key add -
echo "deb https://dl.cloudsmith.io/public/pomerium/pomerium/deb/debian buster main" > /etc/apt/sources.list.d/pomerium-pomerium.list

Homebrew​

brew tap pomerium/tap
brew install pomerium-cli

Docker Image​

The CLI utilizes a minimal docker container. You can find the Pomerium CLI image on dockerhub. It can be pulled in several flavors and architectures.

  • :vX.Y.Z: which will pull the a specific tagged release.

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

  • :latest: which will pull the most recent tagged release.

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

  • :main : which will pull an image in sync with git's main branch.

    docker pull pomerium/cli:main

Source​

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