A Docker-based framework to build reusable, super fast, highly customizable, extensible and local integrated workflow solutions for all kinds of apps.
JavaScript Shell CSS Inno Setup PowerShell Batchfile HTML
Latest commit 0dad20f Jan 29, 2017 @alexfornuto alexfornuto committed with pirog Adds DNS rebinding information. (#1769)
Permalink
Failed to load latest commit information.
.github Docs (#1436) Jul 9, 2016
bin #1357: Refactor windows test and build to include CLI Jun 16, 2016
docs Adds DNS rebinding information. (#1769) Jan 29, 2017
installer #1737: Added GUI to Pantheon based linux desktops Dec 2, 2016
lib #1742: Fixed bug where deleting an app whilst creating another would … Dec 2, 2016
modules/jxcore #1357: Add small node module to handle JX build dependency Jun 15, 2016
plugins Added KALABOX_HOSTOS environmental variable to every container Dec 2, 2016
scripts Update apps for imminent release Nov 25, 2016
src Fixed bug where plugins with undefined config sections were stalling … Dec 5, 2016
tasks Osx fixes (#1682) Oct 26, 2016
test Remove old DNS tests Nov 2, 2016
.bowerrc #1357: Merge in raw gui code Jun 21, 2016
.dockerignore Initial payload Mar 17, 2016
.gitignore #1357: Merge in raw gui code Jun 21, 2016
.jscsrc #1357: Add relevant resources from CLI project Jun 14, 2016
.jshintrc #1357: Merge in code styling tasks Jun 21, 2016
.travis.yml Osx fixes (#1682) Oct 26, 2016
CHANGELOG.md Fixed bug where plugins with undefined config sections were stalling … Dec 5, 2016
CONTRIBUTING.md Docs (#1436) Jul 9, 2016
Gruntfile.js Docs (#1436) Jul 9, 2016
LICENSE.md Initial payload Mar 17, 2016
README.md Upgrade dockerode Nov 3, 2016
TERMS.md Update docs for 2.1 release Oct 16, 2016
appveyor.yml Update docs for 2.1 release Oct 16, 2016
bower.json Release v2.1.3 Nov 25, 2016
kalabox.yml 1407 put apps sys conf (#1416) Jun 28, 2016
mkdocs.yml #1607: Remove restrictions on domain for search modifications. Nov 3, 2016
package.json Release v2.1.3 Nov 25, 2016

README.md

Kalabox

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.

Getting Started

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

  1. Pull down sites they have spun up on their Pantheon dashboard.
  2. Achieve parity with the Pantheon environment locally, including access to power services like Solr and Redis.
  3. Push changes back up to their Pantheon site.
  4. Get Pantheon specific power tools such as Terminus, Drush and WP-CLI.

To read more about the Pantheon plugin check out both the docs and its code.

Creating PHP Apps

The Kalabox PHP app allows users to...

  1. Create basic Drupal, Wordpress and Backdrop sites.
  2. Get some nice power tools to go with their apps like Drush.

To read more about the PHP app check out both the docs and its code.

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.

Support

To get help...

  1. Make sure your question isn't answered in either the core docs, the Pantheon app docs, or the PHP docs.
  2. Thoroughly search the Github issue queue for any existing issues similar to yours.
  3. 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.

Development Releases

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.

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.

Other Resources