Simple Distro Kit - Virtual Machines
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
parazyd c1bbdc16de
Style fix.
8 months ago
extra/blends Add the extra/blends directory with a README file. 3 years ago
lib Update libdevuansdk revision. 9 months ago
.gitmodules Update license headers. 10 months ago
LICENSE add license and readme 4 years ago Style fix. 8 months ago
config Double the size of the /boot partition. 9 months ago
sdk Update license headers. 10 months ago


vm-sdk is simple distro build system aimed at creating Vagrant boxes and other virtual machines.


vm-sdk is designed to be used interactively from a terminal. It requires the following packages to be installed in addition to the dependencies required for libdevuansdk.

sudo permissions are required for the user that is running the build.


qemu qemu-utils



Initial setup

After cloning the vm-sdk git repository, enter it and issue:

git submodule update --init


To update vm-sdk, go to the root dir of the git repo and issue:

git pull && git submodule update --init --recursive

Quick start

Edit the config file to match your needs. Sensible defaults are already there. Then run zsh. To avoid issues, it’s best to start a vanilla version, without preloaded config files so it doesn’t cause issues with libdevuansdk/vm-sdk functions.

; zsh -f -c 'source sdk'

Now is the time you choose the OS and (optionally) a blend you want to build the image for.

Currently supported distros

  • devuan
; load devuan

Once initialized, you can run the helper command:

; build_vm_dist

The image will automatically be build for you. Once finished, you will be able to find it in the dist/ directory in vm-sdk’s root.