https://github.com/rzane/docker2exe

Convert a Docker image to an executable
https://github.com/rzane/docker2exe

Last synced: 11 months ago
JSON representation

Convert a Docker image to an executable

• Host: GitHub
• URL: https://github.com/rzane/docker2exe
• Owner: rzane
• Created: 2020-01-30T16:21:43.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-08-09T05:39:55.000Z (over 3 years ago)
• Last Synced: 2024-06-20T12:48:10.553Z (over 1 year ago)
• Language: Go
• Homepage:
• Size: 43 KB
• Stars: 103
• Watchers: 6
• Forks: 17
• Open Issues: 8
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-starts - rzane/docker2exe - Convert a Docker image to an executable (others)

README

          
# docker2exe

This tool can be used to convert a Docker image to an executable that you can send to your friends!

## Installation

Download a binary from the [releases page](https://github.com/rzane/docker2exe/releases).

    $ mv docker2exe-darwin-amd64 docker2exe

    $ chmod +x docker2exe

    $ ./docker2exe --help

## Usage

To create a new binary:

    $ docker2exe --name alpine --image alpine:3.9

This will create the following files:

    dist

    ├── alpine-darwin-amd64

    ├── alpine-linux-amd64

    ├── alpine-windows-amd64

Now, you can run the executable:

    $ dist/alpine-darwin-amd64 cat /etc/alpine-release

    3.9.5

When the executable is run, we'll check for the `alpine:3.9.5` image on the user's system. If it doesn't exist, the executable will automatically run:

    $ docker pull alpine:3.9.5

### Embedded Mode

In this mode, if the specified image doesn't exist, we'll attempt to load it from a tarball that is embeddded in the executable.

    $ docker2exe --name alpine --image alpine:3.9 --embed

When creating the executable above, the image was dumped to a tarball and baked into the resulting executable:

    $ docker save alpine:3.9 | gzip > alpine.tar.gz

When the executable runs, we'll check for the `alpine:3.9` image on the user's system. If it doesn't exist, the executable will automatically run:

    $ docker load alpine.tar.gz

For small images, this approach works great. In the example above, the resulting executable was under 10MB.