OS build toolkit for Virtual Machines (QEMU/Virtualbox)
Go to file
parazyd c1bbdc16de
Style fix.
2021-02-02 10:28:19 +01:00
extra/blends Add the extra/blends directory with a README file. 2018-09-18 16:55:40 +02:00
lib Update libdevuansdk revision. 2021-01-13 19:00:45 +01:00
.gitmodules Update license headers. 2020-12-23 09:23:10 +01:00
LICENSE add license and readme 2017-02-14 19:34:46 +01:00
README.md Style fix. 2021-02-02 10:28:19 +01:00
config Double the size of the /boot partition. 2021-01-13 19:00:25 +01:00
sdk Update license headers. 2020-12-23 09:23:10 +01:00

README.md

vm-sdk

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

Requirements

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.

Devuan

qemu qemu-utils

Gentoo

app-emulation/qemu

Initial setup

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

git submodule update --init

Updating

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.