Introducing Boxen
Today we’re proud to open source Boxen, our tool for automating and managing Macs at GitHub. Boxen started nearly a year ago as a project called “The Setup” — a…
Today we’re proud to open source Boxen, our tool for automating and managing Macs at GitHub.
Boxen started nearly a year ago as a project called “The Setup” — a pipe dream to let anyone at GitHub run GitHub.com on their development machine with a single command. Now every new GitHubber’s first day starts with unboxing a new laptop and hacking on GitHub in about 30 minutes.
What is it?
Boxen is a framework for managing almost every aspect of your Mac. We built a massive standard library of Puppet modules optimized for Boxen to manage everything from running MySQL to installing Minecraft.
We designed Boxen with teams that work like GitHub in mind. Boxen automatically updates itself every run and opens and closes GitHub Issues as problems arise and get fixed. With Boxen, we treat our development environments with the same care we give production: we test our code and rely on Continuous Integration to deploy changes.
Your Boxen
boxen/our-boxen
Start here to build a boxen for your team. This repo is our recommended template for a basic web development environment. The README shows you how to get started, and the basic configuration
shows off some of Boxen’s standard modules for managing system services and your team’s projects.
boxen/boxen-web
Once you’ve built a boxen for your team, boxen-web is the easiest way to roll it out. It’s a simple Rails app that allows you to onboard folks with a single Terminal command. It’s easy to run on Heroku and uses OAuth to limit access to only members of your GitHub organization.
boxen/puppet-template
Now that your team uses Boxen, you probably want to add support for new services and tools. Starting a new Puppet module can be a little complex, so we’ve wrapped everything you need to write one up into this example module. It follows our own best practices about Puppet module development with tools like cardboard, puppet-lint, and rspec-puppet.
Using Boxen
Once your team writes project manifests for your applications, any member of your team can run them locally with ease.
At any time, you can run a single command to get a project and all its dependencies ready to go.
If any GitHubber wants to hack on GitHub for Mac all they need to do is run:
$ boxen mac
<3
All sorts of GitHubbers use and improve Boxen: shippers, HR, lawyers, designers, and developers. More than 50 people have contributed internal fixes and features, and updates ship almost every day.
We love Boxen. We hope you and your team love it too. Happy automating!
Written by
Related posts
![](https://github.blog/wp-content/uploads/2023/10/Collaboration-DarkMode-2.png?resize=400%2C212)
2024 is the biggest global election year in history. What’s at stake for developers?
GitHub is considering what is at stake for our users and platform, how we can take responsible action to support free and fair elections, and how developers contribute to resilient democratic processes.
![](https://github.blog/wp-content/uploads/2023/10/AI-DarkMode-2.png?resize=400%2C212)
GitHub named a Leader in the Gartner first-ever Magic Quadrant for AI Code Assistants
This year, as part of its annual Magic Quadrant series, Gartner published a first-of-its-kind report analyzing the state of play in the AI Code Assistants market–and named GitHub a Leader.
![AI in software development 2024 survey results with colorful graphics and percentages.](https://github.blog/wp-content/uploads/2024/08/ai-survey-header.png?resize=400%2C212)
Survey: The AI wave continues to grow on software development teams
We surveyed 2,000 people on software development teams at enterprises in the U.S., Brazil, India, and Germany about the use, experience, and expectations around generative AI tools in software development.