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.
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.