Skip to main content

porter update


A detailed guide on updating applications from the CLI can be found here.


porter update builds and updates a specified application given by the --app flag. For example:

porter update --app example-app


This command will automatically build from a local path. The path can be configured via the --path flag. You can also overwrite the tag using the --tag flag. For example, to build from the local directory ~/path-to-dir with the tag testing:

porter update --app example-app --path ~/path-to-dir --tag testing

If the application has a remote Git repository source configured, you can specify that the remote Git repository should be used to build the new image by specifying --source github. Porter will use the latest commit from the remote repo and branch to update an application, and will use the latest commit as the image tag.

porter update --app remote-git-app --source github

To add new configuration or update existing configuration, you can pass a values.yaml file in via the --values flag. For example;

porter update --app example-app --values my-values.yaml

If your application is set up to use a Dockerfile by default, you can use a buildpack via the flag --method pack. Conversely, if your application is set up to use a buildpack by default, you can use a Dockerfile by passing the flag "--method docker". You can specify the relative path to a Dockerfile in your remote Git repository. For example, if a Dockerfile is found at ./docker/prod.Dockerfile, you can specify it as follows:

porter update --app example-app --method docker --dockerfile ./docker/prod.Dockerfile


  • --app (string) Application in the Porter dashboard
  • --dockerfile (string) the path to the dockerfile
  • -e, --env (stringArray) Build-time environment variable, in the form 'VAR=VALUE'. These are not available at image runtime.
  • --method (string) the build method to use ("docker" or "pack")
  • --namespace (string) Namespace of the application (default "default")
  • -p, --path (string) If local build, the path to the build directory. If remote build, the relative path from the repository root to the build directory.
  • --source (string) the type of source ("local" or "github") (default "local")
  • --stream (string) stream update logs to porter dashboard
  • -t, --tag (string) the specified tag to use, if not "latest"
  • -v, --values (string) Filepath to a values.yaml file