THIS PROJECT IS NOW OFFICIALLY DEPRECATED
Kalabox is now deprecated and will EOL sometime later in 2019.
Check out https://www.kalabox.io for information on how to migrate to either Lando or Pantheon Localdev
Kalabox is a free and open source local development environment and workflow tool based on (Docker) container technology. Kalabox allows users to spin up hyper-customized, super-fast development environments and to integrate those environments with their hosting provider or continuous integration workflows.
With Kalabox you can...
- Easily mimic your production environment on local.
- Setup, develop, pull and deploy your sites super fast.
- Standardize your teams dev environments and tools on OSX, Windows and Linux.
- Easily customize or extend tooling, deployment options and basically any other functionality.
- Free yourself from the tyranny of inferior local development products.
Learn more and get general Kalabox information by visting our docs.
Kalabox ships as native installer packages for Windows, OSX, Debian and Fedora. Officially supported versions are available on our releases page. To get informed of new Kalabox releases and project updates we encourage you to sign up for our newsletter.
Once you've installed Kalabox you should have...
- The Kalabox GUI in your applications folder, linux menu or Windows start menu.
- The Kalabox CLI available in your terminal. Type
kboxon a terminal to see.
- The Kalabox engine running a docker daemon.
Kalabox also packages two kinds of special external plugins that generate Drupal, WordPress, Backdrop or Pantheon based projects. Read about them below.
Creating Pantheon Apps
The Kalabox Pantheon app generating plugin allows users to...
- Pull down sites they have spun up on their Pantheon dashboard.
- Achieve parity with the Pantheon environment locally, including access to power services like Solr and Redis.
- Push changes back up to their Pantheon site.
- Get Pantheon specific power tools such as Terminus, Drush and WP-CLI.
Creating PHP Apps
The Kalabox PHP app allows users to...
- Create basic Drupal, WordPress and Backdrop sites.
- Get some nice power tools to go with their apps like Drush.
Creating Custom Apps
You can also easily create your own kinds of apps to develop in Node, Django, Ruby, Python, Frontpage 97, etc. To learn about creating your own apps check out our docs.
To get help...
- Make sure your question isn't answered in either the core docs, the Pantheon app docs, or the PHP docs.
- Thoroughly search the Github issue queue for any existing issues similar to yours.
- If all else fails, create an issue and follow the pre-populated guidelines and the CONTRIB.MD as best as possible.
Some examples of good issue reporting:
Kalabox is an open-source project. As such, support is a community-lead effort. Please help us keep issue noise to a minimum and be patient with the Kalabox community members who donate time to help out.
If you are interested in dedicated support or customizations, check out our support offerings.
We produce development releases for every commit merged into our
v2.1 branch. These releases are not officially supported but we have made them available to intrepid users who want to try the bleeding edge or are interested in trying out a recent bug fix before
an official release is rolled.
- Windows - http://installer.kalabox.io/kalabox-latest-dev.exe
- Debian - http://installer.kalabox.io/kalabox-latest-dev.deb
- Fedora - http://installer.kalabox.io/kalabox-latest-dev.rpm
- macOS - http://installer.kalabox.io/kalabox-latest-dev.dmg
NOTE: Releases can take some time to build after we merge in commits. For that reason you might want to check the time of the last commit and if it is within a few hours you might want to hold off a bit before trying the new latest release.
You can also easily verify that the release you downloaded matches the latest commit. All development releases look something like
v2.1.0-alpha.1-4-g63b0db0. This means 4 commits after the
2.1.0-alpha.1 tag and with commit hash
g63b0db0. You should make sure this commit hash matches or comes before the latest commit.