Files
pass-cli-docker/README.md
T
aneurinandClaude Sonnet 5 d534a21b09 Add Dockerfile and README
Prebuilt glibc image for pass-cli, so Alpine/musl-based CI jobs (e.g.
harmless-easy-bobcat's docker:cli-based deploy workflows) can pull and run
it without hitting missing glibc symbols.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-19 21:05:36 +01:00

1.9 KiB

pass-cli Docker image

A prebuilt, glibc-based container image for Proton Pass CLI (pass-cli).

Why this exists

pass-cli's official Linux binary is dynamically linked against glibc. It does not run under Alpine/musl, even with gcompat or libc6-compat installed — some of the symbols it needs (fcntl64, __res_init, ...) are glibc-specific and aren't shimmed. There's no official musl build and no official pass-cli image, so CI jobs that otherwise run in an Alpine-based container (like docker:cli) can't just apk add pass-cli or run the binary directly.

This image is a small debian:bookworm-slim base with a pinned, checksum-verified pass-cli binary installed, published so that kind of job can pull it and run pass-cli (or a script that calls it) without needing its own glibc environment.

Usage

The image's ENTRYPOINT is pass-cli itself:

docker run --rm code.aneur.in/cloud/pass-cli:<tag> --version

To run your own script against pass-cli instead (login, fetch an item, parse the result, etc.), override the entrypoint and mount the script in:

docker run --rm \
  -e PROTON_PASS_PERSONAL_ACCESS_TOKEN \
  -v "$PWD/my-script.sh:/script.sh:ro" \
  --entrypoint sh \
  code.aneur.in/cloud/pass-cli:<tag> \
  /script.sh

PROTON_PASS_KEY_PROVIDER is set to fs in the image by default, since a container has no kernel keyring for pass-cli's usual session storage.

See code.aneur.in/cloud/cloud's bin/ci/ and .gitea/workflows/*.yml for a real caller of this image.

Updating the pinned version

PASS_CLI_VERSION and PASS_CLI_SHA256 are build args at the top of the Dockerfile. Bump both together — get the new version's hash from https://proton.me/download/pass-cli/versions.json, or download the binary and check it yourself with sha256sum.