Modern applications with built-in automation
Switch branches/tags
Clone or download
chef-ci Update with details from pull request #5849
Obvious fix; these changes are the result of automation not creative thinking.
Latest commit 6490fb0 Nov 15, 2018
Failed to load latest commit information.
.buildkite Merge pull request #5805 from habitat-sh/sm/add-target-to-docker-imag… Nov 14, 2018
.expeditor Send Expeditor notifications to sa habitat specific channel in Chef S… Jul 13, 2018
.github Add debug tips for Window users Aug 21, 2018
.secrets Restore deleted files from 630ee88 Jul 30, 2018
components Merge pull request #5849 from habitat-sh/cm/thread-safe-user-config-w… Nov 15, 2018
docs Add dev docs for creating migrations Jan 18, 2018
images Update the YouTube image Jun 19, 2018
support Merge pull request #5796 from habitat-sh/changed Nov 14, 2018
test Don't change svc directory permissions except when the directory is c… Oct 9, 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 #5831 from habitat-sh/update-cli-docs-for-0.68.0 Nov 8, 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
.gitignore Add a test fixture package Oct 2, 2018
.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 Turn on rust backtraces for travis tests Nov 9, 2018 Update BUILDING docs for Ubuntu 18.04 and docker install Sep 21, 2018 Update with details from pull request #5849 Nov 15, 2018
CODEOWNERS remove Liz from CLI related code owners' Oct 22, 2018 Correct `whom` usage Jul 26, 2018 Fix link for local builder setup instructions Apr 16, 2018
Cargo.lock adds windows friendly behavior to hab pkg env Nov 9, 2018
Cargo.toml Add habitat_http_client to example core crate override Nov 14, 2018
Dockerfile Update to ubuntu 18.04 Sep 20, 2018
LICENSE fix whitespacing and brackets in license Sep 17, 2017 Add myself to Oct 17, 2018
Makefile More significant revisions to release process Nov 13, 2018 MacOS => macOS Aug 8, 2018 Fix typo Nov 13, 2018 Update Aug 16, 2016
VERSION Update version from 0.68.0 -> 0.69.0-dev Nov 8, 2018
Vagrantfile Install docker in Vagrant environment Sep 21, 2018
appveyor.yml Fixing appveyor tests Nov 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 More significant revisions to release process Nov 13, 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.