Rust HTML Shell PowerShell CSS Ruby Other
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.buildkite move build logic for rootless studio into buildkite Aug 15, 2018
.expeditor Send Expeditor notifications to sa habitat specific channel in Chef S… Jul 13, 2018
.github updated per review Jul 12, 2016
.secrets Restore deleted files from 630ee88 Jul 30, 2018
components explicitly error when attempting to remove a docker studio Aug 20, 2018
docs Add dev docs for creating migrations Jan 18, 2018
images Update the YouTube image Jun 19, 2018
support add launcher appveyor build and always publish to unstable Aug 13, 2018
test Revert "Revert "Fix a minor issue with finding the files to run shell… Aug 2, 2018
tmp Restore deleted files from 630ee88 Jul 30, 2018
tools Revert "Revert "Fix existing lints and automate running shellcheck"" Jun 19, 2018
www Merge pull request #5456 from habitat-sh/jb/0.61.0-blog-post Aug 15, 2018
.bldr.toml Merge pull request #4995 from habitat-sh/cm/remove-tarize Apr 26, 2018
.dockerignore Add Dockerfile for building a self contained Builder Sep 19, 2017
.github_changelog_generator Version 0.34.0 Sep 30, 2017
.gitignore Add functions to load packages into the dev environment Oct 13, 2017
.gitmodules BATS suite! Sep 26, 2017
.mailmap Update information about project maintainers Jun 10, 2016
.mention-bot Adding mention-bot and travis.yml Apr 19, 2016
.travis.yml [ci,rustfmt] Formatting due to rustfmt 0.8.2 in Rust 1.28.0. Aug 6, 2018 Document launcher build and release process Apr 16, 2018 Update with details from pull request #5485 Aug 20, 2018
CODEOWNERS Add myself to supervisor related things Aug 20, 2018 Correct `whom` usage Jul 26, 2018 Fix link for local builder setup instructions Apr 16, 2018
Cargo.lock Update Cargo.lock to latest, locking versions of dependencies that break Aug 16, 2018
Cargo.toml Replace all depot_client call locations with api_client calls Aug 9, 2018
Dockerfile Update Dockerfile to use `FROM ubuntu:17.10` since yakkety is EOL. Nov 2, 2017
LICENSE fix whitespacing and brackets in license Sep 17, 2017 Add myself to maintainers Jul 11, 2018
Makefile Extricate builder-depot-client files & rustfmt Aug 13, 2018 MacOS => macOS Aug 8, 2018 Add updating Cargo.lock to release procedure documentation Aug 17, 2018 Update Aug 16, 2016
VERSION Bump to 0.62.0-dev Aug 16, 2018
Vagrantfile Re-add Vagrantfile. May 25, 2018
appveyor.yml add launcher appveyor build and always publish to unstable Aug 13, 2018
build.ps1 adding windows sodium binaries from nuget Dec 16, 2017
docker-compose.yml Build devshell in docker-compose Feb 13, 2017 Fix a few broken links to Slack. Oct 28, 2017 Revert "Revert "Fix existing lints and automate running shellcheck"" Jun 19, 2018

Build Status Build status Slack Discourse status Open Source Helpers

Habitat is open source software that creates platform-independent build artifacts and provides built-in deployment and management capabilities.

The goal of Habitat is to allow you to automate your application behavior when you create your application, and then bundle your application with the automation it needs to behave with the correct run time behavior, update strategies, failure handling strategies, and scaling behavior, wherever you choose to deploy it.

See a quick demo of how to build, deploy and manage an application with Habitat:

Build, Deploy and Manage with Habitat (5:33)

Table of Contents


Graphics that will help you and your team better understand the concepts and how they fit together into the larger Habitat ecosystem.

Where Habitat Fits

Habitat Flow Infographic

Try the interactive infographics on the website!

How Habitat Works

Habitat and Docker

Habitat and Kubernetes

View all diagrams in Docs

Hands-on Demos

Choose any topic to begin learning how Habitat can help your team build, deploy, and manage all of your applications - both new and legacy - in a cloud-native way:

View all demos and tutorials in Learn


You can download Habitat from the Habitat downloads page.

Once you have downloaded it, follow the instructions on the page for your specific operating system.

If you are running macOS and use Homebrew, you can use our official Homebrew tap.

$ brew tap habitat-sh/habitat
$ brew install hab

If you are running Windows and use Chocolatey, you can install our chocolatey package

C:\> choco install habitat

If you do not run Homebrew or Chocolatey, or if you use Linux, you can use the Habitat install script from a bash shell.

$ curl | sudo bash


We are always looking for more opportunities for community involvement. Interested in contributing? Check out our to get started!


Get started with the Habitat tutorials or plunge into the complete documentation.

Code Organization

Core Plans

The Habitat plans that are built and maintained by Habitat's Core Team are in their own repo.

Habitat Supervisor and other core components

The code for the Habitat Supervisor and other core components are in the components directory.


Habitat's website and documentation source is located in the www directory of the Habitat source code. See its README for more information.


The Habitat project's roadmap is public and is on our community page.

The Habitat core team's project tracker is also public and on Github.

Community and support


See for platform specific info on building Habitat from source.

Further reference material

Code of Conduct

Participation in the Habitat community is governed by the code of conduct.


Copyright (c) 2016 Chef Software Inc. and/or applicable contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.