Kalastack is a basic LEMP stack built for Drupal. At its core it is a series of puppet manifests that are managed by Vagrant. Kalastack was built to run primarily on Ubuntu Server 12.04, though it will welcome multiple architectures in the future.

If you are interested in support for other architectures check out Proviso

Kalastack 3 requires at least Vagrant 1.3.5 and VirtualBox 4.2.18 to be run correctly. Before you begin please download both.

System Requirements:

• Kalastack works on both 64 and 32 bit architectures and requires at least 2GB of ram.

Notes: At this time, Kalastack is actively tested on Mac OSX 10.8 and with Vagrant 1.3.3 and VirtualBox 4.2.18. It has also been used on Ubuntu 12.04 both natively and using VirtualBox and Vagrant. You may have to play around with the VT Intel settings on your machine to get it to work. That all said it is not a recommended or supported environment at this time.

Once you have downloaded and installed both Vagrant and VirtualBox, you can build out the complete stack:

$ mkdir ~/kalastack
$ cd ~/kalastack
$ git clone git://github.com/kalamuna/kalastack.git ./
  (or download and expand the latest 3.x tarball from https://github.com/kalamuna/kalastack/tags)
$ vagrant plugin install vagrant-hostsupdater
$ vagrant up

You should now be able to access http://start.kala in your browser!

To ssh into your server, from within ~/kalastack, issue:

$ vagrant ssh

Theoretically this should work but it hasn't been tested but here are the steps.

1. Upgrade your VirtualBox and Vagrant to the correct versions. Vagrant 1.3.5 and VirtualBox 4.2.18
2. Checkout the latest version of 3.x aka

$ cd ~/kalastack
$ git fetch --all #This will grab the new branch
$ git checkout 3.x
  (or download and expand the latest 3.x tarball from https://github.com/kalamuna/kalastack/tags)
$ vagrant up --provison

Please contact us on whether this works or doesn't.

Kalastack uses NFS file sharing. You can access your server webroot at ~/kalabox/www on your host machine. This way you can use your local IDE to edit files on your server.

###Start/Stop

Don't start the box in Virualbox, but instead, from within the kalastack codebase use the command line to spin up the stack:

$ vagrant up

and log in via:

$ vagrant ssh

and spin down the box with:

$ vagrant halt

Kalastack makes use of the Terminatur which is built on top of the amazing Terminus. Please consult the Terminatur Documentation for a complete run down on how to use Kalastack with your Pantheon sites.

Remember that the Kalastack does not automatically update the /etc/hosts file on your host machine, so you'll need add each new site manually in order to visit http://SITENAME.kala in your web browser! Kalastack does, however, manage the hosts file in your VM.

1.3.3.7 SITENAME.kala

Kalastack ships with xdebug for both debugging and profiling.

Debugging is best done with an IDE such as netbeans or eclipse or with a text editor such as SublimeText.

The xdebug setup should already be done on the Kalastack end so you should only need to set up your IDE. Here is some useful documentation for eclipse, netbeans and SublimeText.

For profiling, we recommend you use the webgrind client which comes preconfigured with your Kalastack and is located at http://grind.kala.

Profiling on every page has a performance impact so you must trigger what pages you want to profile by manually appending ?XDEBUG_PROFILE to the URL (see xdebug documentation for more detail) and then checking webgrind.

Many browsers also offer automated tools/plugins to turn profiling on and off, i.e. Xdebug helper for google Chrome.

Currently, Kalastack doesn't come with Solr installed by default. You can, however, easily add it in by following the instructions on the Adding Solr wiki page.

(C) 2013 Kalamuna LLC