Skip to main content


The GitHub integration supports additional flags to provide additional configuration, making it easier to configure its behavior to your liking.

To use the advanced configuration and additional flags, add them as a root key to your port-app-config.yml file, for example to add the createMissingRelatedEntities flag:

createMissingRelatedEntities: true
- kind: pull-request
query: "true"
... mappings configuration

Using advanced configurationsโ€‹

The following advanced configuration parameters are available and can be added to the port-app-config.yml file:

The specPath parameter specifies a list of globPatterns[] that Port's GitHub app will search for port.yml files in.

  • Default value: **/port.yml
  • Use case:
    • If you want the app to scan a different file than port.yml (for example, change configure the app to scan files named my-port-config.yml using the pattern **/my-port-config.yml);
    • If you want the app to ignore port.yml files in certain paths.