wolkenkit
Documentation
News
DocumentationGetting startedInstalling wolkenkitInstalling on Windows

Installing on Windows

To run wolkenkit on Windows you need to setup a few things.

Preparing the system for Hyper-V

As wolkenkit uses Linux-based Docker images, you have to use Hyper-V to run wolkenkit. Currently, wolkenkit does not support native Windows images.

Hyper-V support is experimental

Running wolkenkit on Windows using Hyper-V is experimental, and not yet officially supported.

Using hardware

To run Windows directly on hardware, i.e. without any virtualization, you do not need to take any special steps.

Enable VT-x

You may have to enable VT-x support in your machine's BIOS for Docker to work.

Using VMware Fusion

To run Windows using VMware Fusion, you need to enable Hypervisor applications for your virtual machine. Shutdown the virtual machine and go to Settings > System settings > Processors and RAM > Advanced options. Ensure that Enable Hypervisor applications in this virtual machine is checked. Close the settings to save your changes.

Now locate the file that represents the virtual machine on your host computer. As this file is an archive, open it, and then open the included .vmx file. This file contains the settings for your virtual machine. If not yet present, add the following lines to the file:

hypervisor.cpuid.v0 = "FALSE"
vhv.enable = "TRUE"

After that, start your virtual machine and boot into Windows.

Installing Hyper-V

To install Hyper-V run PowerShell using administrative privileges. Then run the following commands:

$ Enable-WindowsOptionalFeature -Online -FeatureName containers -All
$ Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Restart Windows

Don't forget to restart Windows once the commands have been completed.

Setting up Docker

To run wolkenkit you need Docker 17.09 or higher. To setup Docker on Windows, download and install Docker for Windows.

Setting up Node.js

To run wolkenkit you need Node.js 8.9.1 or higher. We recommend to install Node.js using nvm-windows, which enables switching between different Node.js versions.

So, download and install nvm-windows.

Restart PowerShell and install Node.js using the following command:

$ nvm install 8.9.1
$ nvm use 8.9.1

Setting up wolkenkit

To download and install wolkenkit, run the following command:

$ npm install -g wolkenkit@1.2.0

Verifying the installation

Verify that wolkenkit is installed correctly by running the following command:

$ wolkenkit --version

Yay, congratulations!

You have successfully installed wolkenkit!

To learn how to build and run your first application, have a look at creating your first application 😊!