IF YOU:
- ARE A KALABOX CLI OR KALASTACK USER
- ARE HAVING ISSUES WITH KALABOX/VAGRANT/KALASTACK
- WANT THE BEST LOCAL DEV IN THE GALAXY
THEN WE HIGHLY HIGHLY RECOMMEND YOU CHECK OUT LANDO
Many components of this software have reached end of life and the project is no longer actively maintained
Please check out the successor project Kalabox2. This project is still under development but it very actively supported and should reach feature parity with Kalabox 1 shortly.
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. If you are upgrading to Vagrant 1.5 you may need to go through the Vagrant update process.
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.9 and with Vagrant 1.6.3 and VirtualBox 4.3.12. 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.
*More Notes: On Ubuntu 12.04 with a Kernel of 3.9.0-x or greater, you may have issues with the 4.2.18 VBnot working properly. This is resolved by using the a version of 4.3.x.
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 upYou should now be able to access http://start.kala in your browser!
To ssh into your server, from within ~/kalastack, issue:
$ vagrant sshTheoretically this should work but it hasn't been tested but here are the steps.
- Upgrade your VirtualBox and Vagrant to at least the correct versions. Vagrant 1.3.5 and VirtualBox 4.2.18
- 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 --provisonPlease 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 upand log in via:
$ vagrant sshand spin down the box with:
$ vagrant haltKalastack 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.
Currently, Kalastack doesn't come with front end tooling like grunt, bower, sass, compass and yo installed by default.
You can, however, easily add it in by following the instructions on the Adding front end tooling.
(C) 2014 Kalamuna LLC