linux

beta software! proceed with caution

Download, install and run Linux on OS X in less than 60 seconds!

npm installs hypercore linux and runs it as a daemon using the new Mac OS Yosemite hypervisor (via hyperkit).

See this youtube video for a demonstration with a cool soundtrack.

This module is a low level component that is part of HyperOS, made by the team working on the Dat data version control tool. We are working on integrating the other HyperOS components to support advanced functionality like running containers, sharing filesystems etc.

Mac OS Yosemite only for now, Windows support coming later through Hyper-V integration (see this issue if you wanna help)

WARNING
-----------
- hyperkit is a very new project, expect bugs! You must be running OS X 10.10.3 Yosemite or later and 2010 or later Mac for this to work.
- if you happen to be running any version of VirtualBox prior to 4.3.30 or 5.0 then hyperkit will crash your system either if VirtualBox is running or had been run previously after the last reboot (see xhyve's issues #5 and #9 for the full context). So, if you are unable to update VirtualBox to version 4.3.30 or 5, or later, and were using it in your current session please do restart your Mac before attempting to run xhyve.
- (these warnings were borrowed from coreos-xhyve)


$3

``
npm install linux -g
`

$3

Quickstart:

1. Run linux init in a folder where you want to store your linux runtime config
2. Run sudo linux boot to start the local linux server daemon
3. Run linux ssh to log in to the server daemon over ssh
4. Run linux halt to stop the server daemon when you're done

`
$ linux
Usage: linux [args...]

Commands:
init creates a new ./linux folder in this directory to hold config
boot boots up linux from config in ./linux
status checks if linux is running or not
ssh sshes into linux and attaches the session to your terminal
run runs a single command over ssh
halt runs halt in linux, initiating a graceful shutdown
kill immediately ungracefully kills the linux process with SIGKILL
pid get the pid of the linux process
ps print all linux processes running on this machine
`

$3

`


initialize a linux folder to hold state

$ linux status
Linux is not running
``

special thanks

- thanks to nlf (Nathan LaFreniere) for help, if you like docker you should definitely check out his projects dhyve and dhyve-os
- thanks to boot2docker for some stuff I borrowed from their rootfs folder