{"id":15161769,"url":"https://github.com/docker/base-cli-plugin","last_synced_at":"2025-10-19T16:32:29.714Z","repository":{"id":61628525,"uuid":"537418326","full_name":"docker/base-cli-plugin","owner":"docker","description":"Experimental Docker CLI plugin to detect base images","archived":false,"fork":false,"pushed_at":"2024-04-08T10:52:03.000Z","size":778,"stargazers_count":16,"open_issues_count":5,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-30T01:51:15.343Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/docker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-16T10:55:50.000Z","updated_at":"2023-10-31T03:58:45.000Z","dependencies_parsed_at":"2024-04-08T11:55:41.718Z","dependency_job_id":null,"html_url":"https://github.com/docker/base-cli-plugin","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fbase-cli-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fbase-cli-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fbase-cli-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker%2Fbase-cli-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docker","download_url":"https://codeload.github.com/docker/base-cli-plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237172166,"owners_count":19266626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-27T00:44:47.279Z","updated_at":"2025-10-19T16:32:29.134Z","avatar_url":"https://github.com/docker.png","language":"Go","readme":"**Note:** This repository is not an officially supported Docker project.  \n\n# `docker base` Docker CLI plugin\n\nDocker CLI plugin to detect base images of local or remote container images.\n\n![docker base detect](docs/screenshot.png \"docker base detect\")\n\nThe `docker base detect` command shows the following data about detected base images:\n\n* Image name and tags\n* Image digest\n* Image vulnerabilities\n* Age of image\n* Link to the commit or Dockerfile from which the image was created\n* `Docker Official Image`, `Verified Publisher` or `Sponsored OSS` - if the image is trusted content; either from Docker Official Images, Verified Publishers or Sponsored OSS\n* `unsupported tag` - if the tag in use is not supported any longer (only for Docker Official Images)\n* `tag moved` - if the tag in use has moved in the meantime; a new image was pushed using the same tag \n\n## Installation\n\nTo install, run the following command in your terminal:\n\n```shell\n$ curl -sSfL https://raw.githubusercontent.com/docker/base-cli-plugin/main/install.sh | sh -s --\n```\n\nAlternatively, you can install manually by following these steps:\n\n* Download the plugin binary from the [release page](https://github.com/docker/base-cli-plugin/releases/latest)\n* Unzip the archive\n* Copy/move the binary into `$HOME/.docker/cli-plugins`\n\n## Usage\n\n### `docker base detect`\n\nTo detect base images for local or remote images, use the following command:\n\n```shell\n$ docker base detect \u003cIMAGE\u003e\n```\n\n`\u003cIMAGE\u003e` can either be a local image id or fully qualified image name from a remote registry.\n\n### `docker base login`\n\nTo authenticate with the Atomist data plane, use the following command:\n\n```shell\n$ docker base login \u003cWORKSPACE ID\u003e\n```\n\nFor the security reasons the command does not accept an API key as command parameter. Instead, an API key can be passed\nin via stdin with the parameter `--api-key-stdin`.\n\nThe `login` command will also check the legacy `ATOMIST_API_KEY` environment variable.\n\nAuthentication is not required. If not authenticated, the plugin will only use public data from Docker Official Images,\nDocker Verified Publishers or Docker-sponsored Open Source. Without authentication the `detect` command will not take\ninto account your own data on Docker Hub when searching for matching base images. \n\nVisit [dso.docker.com](https://dso.docker.com/r/auth/integrations) to obtain a `WORKSPACE ID` and `API KEY`.\n\n### `docker base logout`\n\nTo remove the authentication to the Atomist data plane, use the following command:\n\n```shell\n$ docker base logout\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocker%2Fbase-cli-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocker%2Fbase-cli-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocker%2Fbase-cli-plugin/lists"}