Binpot

April 8, 2026 Ā· View on GitHub

The statically compiled, cross architecture, Docker based, binaries pot.

Blog post

MIT

Usage

The usage is focused to build other Docker images.

For example:

FROM alpine:3.14
COPY --from=qmcgaw/binpot:helm /bin /usr/local/bin/helm

šŸ” Search for all image tags šŸ’”

  • The Docker image tags for qmcgaw/binpot follow the following formatting:
    • :name for the latest stable version of the program name
    • :name-v0.0.0 for the semver version of the program name
  • Each Docker image is based on scratch and only contain the binary program at the path /bin.
  • Each Docker image and binary program is built for each of the possible CPU architecture supported by Docker, unless indicated otherwise.
  • Each binary has permissions 500 (read and execute for the user owner)
  • You can change the ownership in the COPY command using --chown=1000 for example, without duplicating the binary in your Docker image layers.
  • Each Docker image has an entrypoint [ "/bin" ] so you can run it as well

Need help? ā–¶ļø Create a discussion

Thinking of copying the binary for your host?

Programs available

ProgramLast versionImage tagsArchitectures
bitv1.1.2Docker Huball
buildxv0.33.0Docker Huball
composev5.1.1Docker Huball
dlvv1.26.1Docker Hublinux/amd64 and linux/arm64
dockerv29.4.0Docker Huball
ghv2.89.0Docker Huball
gofumptv0.9.2Docker Huball
golangci-lintv2.11.4Docker Huball
gomockv0.6.0Docker Huball
gomodifytagsv1.17.0Docker Huball
go-outline9736a4bDocker Huball
gopkgsv2.1.2Docker Huball
goplayv1.0.0Docker Huball
goplsv0.21.1Docker Huball
gotestsv1.9.0Docker Huball
helmv4.1.3Docker Huball
implv1.2.0Docker Huball
kubectlv1.35.3Docker Huball
kubectxv0.11.0Docker Huball
kubensv0.11.0Docker Huball
logo-lsv1.3.7Docker Huball
logo-lsv1.3.7Docker Huball
mockeryv3.7.0Docker Huball
mockgenv0.6.0Docker Huball
sternv1.33.1Docker Huball
supervisordv0.7.3Docker Huball

ā„¹ļø all architectures means: linux/amd64, linux/386, linux/arm64, linux/arm/v7, linux/arm/v6, linux/ppc64le, linux/s390x, linux/riscv64

Want more!? ā–¶ļø Create an issue!

How it works

  1. For each program, a Dockerfile describes how to build it. The final binary is placed on a final scratch based Docker image. Example: helm has ./dockerfiles/helm/Dockerfile
  2. For each program, a Github Action workflow is triggered when its Dockerfile or the workflow itself is changed. This workflow takes care of:
    1. Cross build the program for all CPU architectures
      • If one architecture is not supported such as for dlv, build the unavailable program
    2. Pushing the images containing the program to Docker Hub and ghcr.io

Note on dlv

šŸ’ Concerning dlv: all images are built for all architectures even if the program does not support all of them. A substitute Go program printing dlv v1.7.0 is unavailable on <platform name> and exiting with exit code 1 is used for unsupported platforms. This is like so so you can still cross build with all the architectures, especially if the program is an optional dependency. This is often the case for VSCode development containers for instance. In this case, if you try to build for arm/v7 and need dlv as an optional dependency, your COPY --from=qmcgaw/binpot:dlv will not fail.

Copy the binary on your host

If you want to use the binary directly on your host, you can do it with Docker. This has the advantage that it will automatically get the right binary for your host platform.

In the following we want to install helm on our host.

For example:

export PROGRAM="helm" && \
  docker pull "qmcgaw/binpot:$PROGRAM" && \
  containerid="$(docker create qmcgaw/binpot:$PROGRAM)" && \
  docker cp "$containerid:/bin" "/usr/local/bin/$PROGRAM" && \
  docker rm "$containerid"

Test Helm works with helm

TODOs

  • Change version of go-outline once a release tag is made: Github issue