Basic terms and concepts


An app is a collection of code repositories that have been connected from your version control system. In the context of the Humanitec platform, these are called modules. You can deploy your apps to one or more environments in your Kubernetes infrastructure. For each environment, you can define a set of configurations, environment variables, and secrets.

Deployment draft

A deployment draft is a set of changes to the environment that is scheduled to be deployed. It shows you a preview of the changes that will be applied before you deploy them.

When you create an app, the platform will create a deployment environment and take you to the overview screen. Any changes you make to the environment will be stored in a new draft. Whenever you deploy the app, a new draft will be created.


A deployment environment is a designated space in your Kubernetes infrastructure where your app runs. At this time, you can create up to three environments per app.

See the Environments page for more details.


A module is a code repository that has been connected to the platform from your GitHub organization. Users in your Humanitec organization can create apps, add one or more modules, and deploy them together to a Kubernetes cluster.

See the Modules page for more details.

Org admin

An org admin is a GitHub user with administrative privileges to a given organization that’s been linked with the Humanitec platform.

See the GitHub organizations page for more details.

Org user

An org user is a GitHub user that is part of an organization that’s been linked with the Humanitec platform.