graboid

README

🚧

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

🚧

graboid

ClientLESS Docker Image Downloader

Install

macOS

$ 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

$ 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

$ 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

$ graboid blacktop/scifgif:latest

Import image into docker

$ docker load -i blacktop_scifgif.tar.gz

Download with a Proxy

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

Extract a file from the image's filesystem 🚧 🆕

$ graboid extract blacktop_ghidra_beta.tar.gz

NOTE: Press <enter> to expand a layer and press <space> to extract file

TODO

• parallelize the layer downloads to decrease the total time to download large images
• add image signature verification (Notary?)
• 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

Documentation

Overview

Copyright © 2019 NAME HERE <EMAIL ADDRESS>

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.