https://github.com/nlf/dhyve-os

a tiny OS for running docker in xhyve
https://github.com/nlf/dhyve-os

Last synced: about 2 months ago
JSON representation

a tiny OS for running docker in xhyve

• Host: GitHub
• URL: https://github.com/nlf/dhyve-os
• Owner: nlf
• Created: 2015-07-30T23:00:23.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2016-08-11T12:51:42.000Z (about 8 years ago)
• Last Synced: 2024-04-22T03:19:30.838Z (5 months ago)
• Language: Shell
• Homepage:
• Size: 2.87 MB
• Stars: 194
• Watchers: 7
• Forks: 19
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-starred - nlf/dhyve-os - a tiny OS for running docker in xhyve (others)

README

        
# DhyveOS

DhyveOS is a lightweight Linux distribution made specifically to run [Docker](https://www.docker.com/) containers within the [xhyve](https://github.com/mist64/xhyve) hypervisor on OS X. It runs completely from RAM, is a small ~14MB download and boots in ~5s (YMMV).

## Features

* Uses 9P over virtio to mount your user's home directory so volume mappings work.

* Docker runs on port 2375 without TLS

* Designed for use with [dlite](https://github.com/nlf/dlite)

* Default root password: dhyve

* Default docker user password: docker

* Uses btrfs for the docker filesystem

## Building

Building DhyveOS requires docker. To build it, just run `make`. Binaries will be located in the `output` directory.

Downloads and ccache output are stored in named docker volumes to speed up subsequent builds.

Running `make clean` will remove the output directory as well as the intermediate container (if it exists).

`make dist-clean` will additionally remove the base image, as well as the named volumes.

If you'd like to tweak the buildroot configuration, run `make config`. When you save changes they will be copied to the `config` directory appropriately.

To make changes to the kernel configuration, run `make linux-config`. When saving, make sure to specify the filename `/tmp/config/kernel` or your changes will be lost.

## Caveat Emptor

DhyveOS is currently designed and tuned for development.  Using it for any kind of production workloads at this time is highly discouraged.