Skip to main content

Habitat Builder system requirements

See the following sections for Chef Habitat On-Prem Builder’s requirements.

Requirements

  • Deploy Habitat Builder on a Linux distribution supported by Habitat.

  • The Linux OS must support the systemd process manager.

  • You can deploy on bare metal, a VM, or a container image.

  • Match CPU and RAM to your deployment purpose:

    • Use 2 CPUs and 4 GB RAM for trial deployments.
    • Use 16 CPUs and 32 GB RAM for production deployments.
  • Provide enough free disk space:

    • 2 GB for the baseline Chef Habitat On-Prem Builder services,
    • 15 GB or more for the latest Chef Habitat On-Prem Builder core packages,
    • 30 GB or more to download and expand the core package bootstrap in the volume containing /tmp.

    Recommended disk space:

    • 50 GB for trial deployments.
    • 100 GB for production deployments.
  • Outbound network (HTTPS) connectivity to the WAN is required for the initial install.

  • Inbound network connectivity from the LAN (HTTP/HTTPS) is required for internal clients to access Chef Habitat On-Prem Builder. This is port 80 or port 443 if you plan to enable SSL.

  • An OAuth2 authentication provider is required. Chef Automate v2, Azure AD, GitHub, GitHub Enterprise, GitLab, Okta, and Bitbucket (cloud) are verified. You can request support for additional providers.

Optional: Memory filesystem storage

Follow these guidelines for filesystem storage:

  • Chef Habitat On-Prem Builder needs substantial storage space for packages. Make sure your filesystem has enough free space.
  • By default, Chef Habitat On-Prem Builder stores package artifacts in a MinIO instance, typically at /hab/svc/builder-minio/data.
  • If you need more storage, create a mount at /hab and point it to your external storage. This isn’t required if you already have enough free space.
  • To use Artifactory instead of MinIO for object storage, see the Habitat On-Prem Builder and Artifactory documentation.
Edit this page on GitHub

Thank you for your feedback!

×