KUSANAGI for Vagrant

Notable features

  • Install KUSANAGI without depending on the OS
  • Easily set up KUSANAGI environment
  • Set up KUSANAGI on a local PC
  • Focus on development/verification without worrying about affecting other developers

Install outline

  1. Install VirtualBox
  2. Install Vagrant
  3. Install the KUSANAGI Vagrant Box

*This guide was written for Windows, but can also be used for MacOS and others

The following conditions will cause the installation to fail

  • The host PC’s CPU does not support hardware-assisted virtualization. PC’s built after 2008 typically do, however it is commonly disabled in the BIOS. Confirm that VT is not set to ‘Disable’ in the BIOS settings. Some older PC’s may not have hardware-assisted virtualization at all, in which case you would need to switch to a newer PC that does.
  • The username includes Japanese characters (on Windows). Create an account using only alphabet characters and try running vagrant up
  • Vagrant Box files take some time to download during the first vagrant up. Without enough bandwidth, there is a good chance that the download will fail, so be sure to use a connection with sufficient bandwidth.
  • Security settings in Mac OS High Sierra and later will block VirtualBox by default. Check System Preference -> Security&Privacy settings If Oracle America, Inc. is blocked, so allow it.

Installing VirtualBox

  1. Download VirtualBox for Windows from: http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html
  2. Double-click on the downloaded file to start the installer. Click OK throughout installation.
  3. After installation, this icon will appear:

Installing Vagrant

  1. Download Vagrant for Windows(64bit) from: https://www.vagrantup.com/downloads.html
  2. Double-click the downloaded file to start the installer, and click OK throughout the installation.
  3. Restart your PC.
  4. After installation, run vagrant --version from the command prompt and the following version information will be displayed.

Installing the KUSANAGI Vagrant Box

Launch the command prompt:

Execute the following commands:

  1. mkdir kusanagi(Create a directory with name of your choice, i which the Vagrantfile will be created)
  2. cd kusanagi (Move to the new directory)
  3. vagrant init yuya_tajima/kusanagi(Create Vagrantfile)

Leave the command prompt open.

Edit the Vagrantfile

Open the Vagrantfile in an editor and make the changes below.

This allows you to set the SSH connection port, and enable communication between the host OS and guest OS.

You can change the port number and IP address according to your needs.

Remove the comment-out


# config.vm.network "private_network", ip: ""


config.vm.network "private_network", ip: ""

Add this extra line:


# config.vm.network "forwarded_port", guest: 80, host: 8080


# config.vm.network "forwarded_port", guest: 80, host: 8080
config.vm.network "forwarded_port", guest: 22, host: 12222, id: "ssh"

Save and close the Vagrantfile after you have finished editing it.

Launch the virtual machine

Execute vagrant up from the command prompt. If there is a problem, make sure that your current directory is the same directory as the one that the Vargrantfile is in.

Onve the virtual machine has launched, use an SSH client to log in as a guest with the following info:
User name: vagrant
Port number: Use the one set in the Vagrantfile(in the example above, it was 1222.)
Password: vagrant

KUSANAGI initilization and provisioning

After successfully logging in, the screen below will be displayed.
You are logged is as a ‘vagrant’ user right after SSH login, so use $ sudo su - to switch to ‘root’ user.

Read the following document for the initialization procedure:

KUSANAGI Initialization

After running kusanagi provision as in the instructions above, adding the following code to the hosts file on the host OS(Windows) will allow you to view a KUSANAGI site built on the guest OS from a browser on the host OS. {FQDN name set during kusanagi provisioning}