Installing Kalabox
- Before installing, please check the Requirements (listed below).
- Double click on the installer.
- NOTE: Apple may warn you that Kalabox is "from an unidentified developer." That's because we're hip with the indie crowd. To get around the warning (until we sell our souls to Apple), either right-click on Kalabox and select "Open," or, if you're tired of Apple's bullshit, follow these directions to disable Gatekeeper.
- Follow the installation instructions for Kalabox!
Requirements
- For now, Kalabox supports 64-bit operating systems only. So if you're on a 32-bit machine, just hang tight, as support is coming soon!
- Kalabox needs Vagrant 1.2.2 and VirtualBox 4.2.8 to run. It will install them for you if you don't have them, or upgrade them for you if you're on older versions.
- Kalabox dynamically allocates memory to itself based on your available RAM. It needs at least 1GB available to run.
- Kalabox has been tested mostly on Mac OS X 10.8 and partially tested on 10.7. It may work on 10.6 or lower. If you try it out on an older OS X version, please share your experience.
Known Issues
- The Mac OS X firewall can interfere with the underlying technologies, Vagrant and NFS, that Kalabox uses. Check out these instructions for tips on using Kalabox with your firewall.
Connecting with Pantheon
Kalabox can connect to Pantheon and download sites you have on your Pantheon account. To download a site from Pantheon, follow these steps:
- Download your site aliases by visiting "Your Sites" on Pantheon and clicking the "Download all Drush aliases" button.
- In Kalabox, go to the Configure tab and drag-and-drop the site aliases file you downloaded to the upload widget.
- Make sure that you have an SSH key that's connected to your Pantheon account on your computer in your home directory's .ssh folder.
- This SSH key needs to be loaded before Kalabox can use it. You can ensure it's loaded by performing an action on your computer that requires it (e.g. running "git pull" on a Git repository or connecting to a remote server). An easy way to load it through the command line is to run the "ssh-add" command. If your key doesn't have a standard name (e.g. id_rsa or id_dsa), you need to pass its name to ssh-add.
- Go to the "My Sites" tab in Kalabox and download away! If your sites don't appear, try restarting Kalabox.
Steps 1 - 3 are only needed the first time you go to download sites from Pantheon. Step 4 is needed every time, though we're working to find a solution that makes this step unnecessary. If you experience errors when downloading a site, double-check that you performed step 4.
If you're interested in interacting with your Pantheon sites directly from the command line, you can use some of the handy Drush commands that come packaged with Kalastack.