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 7821ee8b8d
Update libdevuansdk revision.
1 year ago
extra/blends Add the extra/blends directory with a README file. 2 years ago
lib Update libdevuansdk revision. 1 year ago
.gitignore ignore temporary .zshrc 4 years ago
.gitmodules Update .gitmodules. 1 year ago
LICENSE add license and readme 4 years ago Vagrant prefers VirtualBox 5.1 3 years ago
config Update libdevuansdk revision. (Adds cloud-based VM support) 2 years ago
sdk Add sdkvm.blend in the blend map. 1 year 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.


virtualbox vagrant qemu qemu-utils


app-emulation/virtualbox app-emulation/vagrant app-emulation/qemu

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_vagrant_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.

For more info, see the doc/ directory.


Devuan’s SDK was originally conceived during a period of residency at the Schumacher college in Dartington, UK. Greatly inspired by the laborious and mindful atmosphere of its wonderful premises.

The Devuan SDK is Copyright (c) 2015-2017 by the Foundation

Devuan SDK components were designed, and are written and maintained by:

This source code is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this source code. If not, see