blacktop
graboid
Go

Clientless Docker Image Downloader

Last updated Feb 4, 2026
80
Stars
7
Forks
9
Issues
0
Stars/day
Attention Score
3
Language breakdown
Go 93.3%
Makefile 4.0%
Shell 2.8%
Files click to expand
README

🚧

Docker broke/changed the API and now graboid doesn't work

🚧

graboid Logo

graboid

ClientLESS Docker Image Downloader


Install

macOS

bash
$ brew install blacktop/tap/graboid

linux/windows

Download from releases

Why

This project was created for people whom can't install docker on their desktops, but still need to be able to download docker images from DockerHUB and then transfer them to another machine running docker.

Getting Started

sh
$ graboid --help

Docker Image Downloader

Usage: graboid [flags] graboid [command]

Available Commands: extract Extract files from image help Help about any command tags List image tags

Flags: --config string config file (default is $HOME/.graboid.yaml) -h, --help help for graboid --index string override index endpoint (default "https://index.docker.io") --insecure do not verify ssl certs --proxy string HTTP/HTTPS proxy --registry string override registry endpoint -V, --verbose verbose output

Use "graboid [command] --help" for more information about a command.

List available image tags

sh
$ graboid tags blacktop/scifgif

• Querying Registry image=blacktop/scifgif • Tags: • 0.2.0 • 0.3.0 • 1.0 • latest

Download the docker image blacktop/scifgif

sh
$ graboid blacktop/scifgif:latest

Import image into docker

sh
$ docker load -i blacktop_scifgif.tar.gz

Download with a Proxy

sh
$ graboid --proxy http://proxy.org:[PORT] blacktop/scifgif:latest

Extract a file from the image's filesystem :construction: :new:

sh
$ graboid extract blacktopghidrabeta.tar.gz
NOTE: Press <enter> to expand a layer and press <space> to extract file

extract

TODO

  • [ ] parallelize the layer downloads to decrease the total time to download large images
  • [ ] add image signature verification (Notary?)
  • [x] ensure support for long connections for large downloads

Issues

Find a bug? Want more features? Find something missing in the documentation? Let me know! Please don't hesitate to file an issue

License

MIT Copyright (c) 2017-2021 blacktop

🔗 More in this category

© 2026 GitRepoTrend · blacktop/graboid · Updated daily from GitHub