{"id":13840712,"url":"https://github.com/tuxotron/docker-image-generator","last_synced_at":"2025-07-11T09:32:56.977Z","repository":{"id":55500593,"uuid":"254515505","full_name":"tuxotron/docker-image-generator","owner":"tuxotron","description":"Customized docker images generation toolkit","archived":false,"fork":false,"pushed_at":"2021-10-14T13:25:23.000Z","size":132,"stargazers_count":25,"open_issues_count":1,"forks_count":8,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-05T17:25:37.251Z","etag":null,"topics":["bugbounty","docker","infosec","pentesting"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tuxotron.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}},"created_at":"2020-04-10T01:26:32.000Z","updated_at":"2023-06-15T21:50:38.000Z","dependencies_parsed_at":"2022-08-15T01:50:48.621Z","dependency_job_id":null,"html_url":"https://github.com/tuxotron/docker-image-generator","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/tuxotron%2Fdocker-image-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuxotron%2Fdocker-image-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuxotron%2Fdocker-image-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuxotron%2Fdocker-image-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tuxotron","download_url":"https://codeload.github.com/tuxotron/docker-image-generator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225712658,"owners_count":17512451,"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":["bugbounty","docker","infosec","pentesting"],"created_at":"2024-08-04T17:00:53.208Z","updated_at":"2024-11-21T10:30:40.861Z","avatar_url":"https://github.com/tuxotron.png","language":"Go","funding_links":[],"categories":["Go","Go (531)"],"sub_categories":[],"readme":"# Docker Image Generator\nThis tool allows you to create docker images or Dockerfiles customized with the tools of your choice (that are integrated in this tool).\n\nThis is ideal for when you need some tool that you don't have installed and/or don't want to install or mess your system with. Create your image, run the container, use the tool/s and throw it away when you are done, or keep it for future uses. \n\n## Installation\n\nYou will require to have installed [Docker](https://www.docker.com) and [go](https://golang.org) in your system. Eventually I will be releasing the binaries for the three major platforms, so you won't required to have go installed. \nClone this repository and build the binary:\n\n    git clone https://github.com/tuxotron/docker-image-generator\n    cd docker-image-generator\n    make build\n    \nOr download the compiled binary for your architecture from the [latest release](https://github.com/tuxotron/docker-image-generator/releases).\nAfter downloading, give it executable permission and move it somewhere in your PATH:\n\n    chmod +x doig-xxx\n    sudo mv doig-xxx /usr/local/bin/doig\n\n## Usage\n\n    ./doig\n    This tool creates a customized docker image with the tools you need\n    \n    Usage: doig [--tools TOOLS] [--category CATEGORY] [--image IMAGE] [--dockerfile] [--list] [--update]\n    \n    Options:\n      --tools TOOLS, -t TOOLS\n                             List of tools separated by blank spaces\n      --category CATEGORY, -c CATEGORY\n                             List of categories separated by blank spaces\n      --image IMAGE, -i IMAGE\n                             Image name in lowercase\n      --dockerfile, -d       Prints out the Dockerfile\n      --list, -l             List the available tools and categories\n      --update, -u           Update tools\n      --help, -h             display this help and exit\n\nThe first time you run the application it will download the lates set of tools and will create a directory called .doig in your home directory. If you want to set up the application in a different directory, just define the environment variable `DOIG_PATH` with the PATH where you want to setup *doig*.\n\n## Examples\n\n* To update the tools:\n\n        ./doig -u\n        [*] Updating tools ...\n        [*] Tools updated\n        ...\n        ...\n    \n\n* List the tools available alphabetically:\n\n        ./doig -l\n        [*] Tools\n          [-] altdns\n          [-] amass\n          [-] anonsurf\n        ...\n        [*] Categories\n          [-] reversing\n          [-] exploitation\n          [-] osint\n        ...\n        \n* Prints out a Dockerfile with the tools of your choice:\n\n        ./doig -d -t nmap sqlmap wfuzz\n        [*] Adding nmap\n        [*] Adding sqlmap\n        [*] Adding wfuzz\n        \n        FROM ubuntu:18.04\n        \n        RUN apt update \u0026\u0026 \\\n            apt install -y software-properties-common git curl p7zip-full locales \u0026\u0026 \\\n            add-apt-repository -y ppa:longsleep/golang-backports \u0026\u0026 \\\n            apt update \u0026\u0026 \\\n            localedef -i en_US -c -f UTF-8 -A /usr/share/locale/locale.alias en_US.UTF-8\n        \n        ENV LANG en_US.utf8\n        \n        RUN   apt install -y nmap \u0026\u0026 \\\n          apt install -y sqlmap \u0026\u0026 \\\n          apt install -y python-setuptools wfuzz \u0026\u0026 \\\n           rm -rf /var/lib/apt/lists/*\n           \nYou can copy that file and use it with `docker [image] build`.\n\n* Creates a docker image:\n\n        ./doig -i mytools -t nmap sqlmap wfuzz\n        [*] Adding nmap\n        [*] Adding sqlmap\n        [*] Adding wfuzz\n        Step 1/4 : FROM ubuntu:18.04\n         ---\u003e 4e5021d210f6\n         ...\n         ---\u003e 92bb29c4fc45\n        Successfully built 92bb29c4fc45\n        Successfully tagged mytools:latest\n        \nThis creates a docker image called `mytools`. Now you can just get shell inside and use your tools:\n\n        docker run -it --rm mytools\n        root@dff16ee1f45c:/opt#\n\nBy default we'll be in /opt directory. Inside this directory you will find a file called tools.txt (if we added any tools when creating the image), which contains the list of the tools added to the image.\n        \nOr run a tool directly without getting a shell:\n\n        docker run -it --rm mytools nmap localhost\n        \n        Starting Nmap 7.60 ( https://nmap.org ) at 2020-04-10 21:35 UTC\n        Nmap scan report for localhost (127.0.0.1)\n        ...\n        \nEach tool has assigned a category, so it is also possible to install all the tools of a specific category.\n\nThis would create an image with all the tools belonging to the `recon` category\n\n        ./doig -i mytools -c recon\n        \nYou can also spcify individual tools and categories. This would create an image with all the tools belonging to the `recon` category, plus sqlmap:\n\n        ./doig -i mytools -c recon -t sqlmap\n\nThis would create an image with all tools:\n\n        ./doig -i mytools -c all\n        \n## TO DO\n\nI'm actively working on fixes, cleanup, improvements, etc.\n\nI hope you find this tool useful. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuxotron%2Fdocker-image-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftuxotron%2Fdocker-image-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuxotron%2Fdocker-image-generator/lists"}