Basic terms and concepts


The API URL is created by the Humanitec API gateway to expose the endpoints from all of your app’s modules under a single URL. If you enable the API gateway in your app, then it will run a discovery process to combine the endpoints from all of your modules into a single API.


In the context of Walhall, an app is a set of repositories that have been linked from your GitHub organization (known as modules) that has been deployed to an environment in Kubernetes. In Walhall, you can manage the deployment configurations and secrets for your app.

Deploy ready

“Deploy ready” refers to whether or not a given module can be deployed with your app. In order to be “deploy ready,” the module’s repository must satisfy these conditions:

  • It must include a Drone file (.drone.yml). See the Drone page for more details.
  • It must include a Dockerfile.
  • It must include a git tag.


A deployment environment is a designated space on Walhall’s 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.

Humanitec API gateway

The Humanitec API gateway acts as a core authentication layer for your modules. You can use it to combine your modules into a single API. Click here for instructions on how to incorporate it into your app.


A module is a code repository that has been linked to Walhall from your GitHub organization. Modules can be added to apps and deployed together to form microservice architectures.

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 Walhall.

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 Walhall.