How do I export my settings to a porter.yaml file?

Last updated: September 12, 2025

Context

When managing your application settings with Porter, you may want to export your current configuration to a porter.yaml file for version control or automation purposes.

Answer

To export and use your Porter settings in a YAML file:

  1. Go to your application's Settings tab in the Porter dashboard

  2. Export your current settings as a porter.yaml file

  3. Place the porter.yaml file in your repository

  4. Update your GitHub workflow file to reference the YAML file by adding the following parameter to your porter apply command: 

    exec porter apply -f /path/to/porter.yaml

Note: The path specified in the workflow file should be relative to the root of your repository, not the GH workflow file location.

Once configured, Porter will detect and apply any changes made to the YAML file during workflow execution.