Boxen

Quit worrying about your tools. Automate the pain out of your development environment. Boxen installs your dependencies so you can focus on getting things done.

Download
* on GitHub *

Features >>

  • Keep your head.

    Worried you might miss out on a crucial update?

    Don’t! Each time you run your boxen, it automagically updates to the latest release.

  • Protect Yourself, from yourself.

    Manage the dependencies of all of your apps in one place.

  • A future, with jetpacks.

    Need a few different databases and languages to run your apps?

    We’ve got you covered. They're just a few lines of code away.

  • Just Add Fire.

    Fully configurable, insta-dev environments for you and yours. You can even install Minecraft with it.

More About Boxen >>

Boxen is your team's IT robot. It's a dangerously opinionated framework that automates every piece of your development environment. GitHub, Inc. wrote the first version of Boxen (imaginatively called “The Setup”) to help employees start shipping on day one. It's configuration management for everyone: Designers, HR mavens, legal eagles, and developers. We believe that development is production, so we value consistency, predictability, and reproducibility over artisanal, hand-tweaked development environments.

We ditched The Setup and wrote Boxen so it's easily usable by any company, not just GitHub. We've extracted most Boxen features into modules that can be mixed and matched to create your perfect environment, and custom behavior is always just a module away.

What can it do?

Boxen can clone your projects, install your toolchains, apply security policies, configure your favorite music player, set your screensaver, clone your dotfiles, and scream for help when things go haywire. The example repository at boxen/our-boxen shows how to require Full Disk Encryption, install packages from Homebrew, ensure the presence of some default Ruby and node.js versions, run nginx, and resolve custom requests to a local .dev domain.

We've written roughly a bajillion libraries for Boxen, covering everything from configuring elasticsearch to disabling “natural” scrolling to installing Minecraft. If we don't have what you need, you can write your own. You can customize and extend your team's Boxen environment as well: If you have to install something manually, it's a bug.

How do I customize this thing?

Boxen's secret sauce is Puppet. New to Puppet? Never fear! We've written docs aimed at beginners and experts alike. Boxen also makes it easy for you to customize your own box in reproducible, shareable ways. Boxen is released under the MIT license, so go crazy.


What about Linux, or Windows?

Boxen only works on Mac OS X (Mountain Lion or above), because that's what we hack on every day. Puppet is really good at supporting multiple platforms, though, so send us some pull requests!