When does the Initial Deploy job run compared to Predeploy jobs?

Last updated: February 9, 2026

Context

When working with Porter environments, users may notice different types of deployment jobs, including "Initial Deploy" and "Predeploy" jobs. Understanding when these jobs execute is important for proper environment setup and deployment configuration.

Answer

The Initial Deploy and Predeploy jobs run at different stages of the deployment process:

  • Initial Deploy: This job runs during the initial setup of a new environment, before any application services are deployed to the cluster.

  • Predeploy: These jobs execute after a new build is created but before deploying services to the cluster. They are commonly used for tasks such as:

    • Database migrations

    • Configuration preparation

    • Environment setup tasks

For more information about configuring predeploy jobs, refer to the predeploy jobs documentation.