Porch Documentation

Learn how to deploy, use, and operate Porch for Kubernetes-native package orchestration.

Welcome to the Porch documentation. Porch is a Kubernetes extension apiserver that manages the lifecycle of KRM configuration packages in Git and OCI repositories.

Getting Started

New to Porch? Start here:

Documentation Sections

Learn

Use

Operate

Contribute

Additional Resources

  • kpt Project - Porch is part of the kpt project and uses kpt for package operations
  • Release Notes - What’s new in each version

Overview

Porch is a Kubernetes extension apiserver for managing the lifecycle of KRM configuration packages in Git repositories. It provides a Kubernetes-native API for package operations, enabling GitOps workflows with approval gates, automation, and collaboration.

Porch Concepts

The fundamental topics necessary to understand Porch as “package orchestration” on a conceptual level.

Installation

A set of guides for installing Porch prerequisites, the porchctl CLI, and deploying Porch components on a Kubernetes cluster.

Guides

Step-by-step guides for using Porch to manage configuration packages

Architecture & Components

Porch’s internal architecture and component design

Configuration & Deployments

Configuring and deploying Porch in different environments

CLI / API Reference

Command-line and API reference documentation for Porch

Troubleshooting & FAQ

Common issues, solutions, and frequently asked questions for Porch

Glossary

Definitions of key terms and concepts used in Porch documentation

Contributing

How to contribute to Porch documentation and codebase

Last modified June 2, 2026: Docs porch portover to kpt (#1016) (8d2da78)