Skip to content

Repository files navigation

Docker runtime VM with Alpine Linux

This is lightweight alpine based docker runtime vm for those who do not want to run the Docker Toolbox on OSX or Windows. This is much more convenient and avoids all the pitfalls and problems like high CPU usage of the Docker Toolbox / hypervisor implementation.

This VM is thin and configurable and easy to set up / use.

Prerequisite

Install Vagrant.

vagrant plugin install vagrant-alpine
vagrant plugin install vagrant-env
vagrant plugin install vagrant-vbguest

Usage

The base resources for a singel VM are 6GB of ram and 2 CPU cores.

Change these in the Vagrant file directly or by using these environment properties:

DOCKER_VM_MEMORY
DOCKER_VM_CPU
DOCKER_VM_NAME

To run the VM simply type:

vagrant up

IMPORTANT: Once this completes, to access the docker daemon the vm has to be restarted. Thus, once everything is installed, run:

vagrant reload

Now, you are ready to use docker. To get into your vm run:

vagrant ssh

This will give you a prompt for the vagrant user which is set up to be able to run and access docker commands.

Composer is also installed.

Portforwarding

The VM by default forwards port 8989 and 32768. Further ports can be defined as follows (comma separated list):

DOCKER_VM_PORTS="1234,3155,333,1234"

To apply the new forwarded ports, simply restart the vm with:

vagrant reload

One a port is opened, you can access everything like you would normally on localhost. For example running a simple web server inside the vm once port 9999 is forwarded:

vagrant@alpine38:~ # python -m SimpleHTTPServer 9999

Then on your guest you would open http://localhost:9999 and could see something like this:

Directory listing for /
.ash_history
.bash_profile
.profile
.ssh/
gohome/

Mounted Folders

Mount points can be added with (comma separated list):

DOCKER_VM_MOUNTS="/home/user/my_data,/home/user/my_data2"

About

A minimal Alpine based docker runtime environment

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages