What happens when I sync an app?

Last updated: February 3, 2026

QUESTION

What happens when I sync an app? 

ANSWER

Syncing an app performs validation of the syntax of the app's TOML files.

The Nuon control plane creates builds for each component. A build creates an OCI artifact that is stored in the Nuon org's container registry like AWS ECR.

The artifacts are used by Nuon to provision and update an install in the customer's cloud.

If you update the app's configuration, you must run nuon apps sync to trigger a re-build of any changed components.

Nuon automatically detects and re-builds components if their TOML files or referenced files like Helm values change.

However, you must manually rebuild in the dashboard (or with the CLI) when:

  • Git repository source code changes (e.g., Terraform modules or Helm charts)

  • Source code in your app repository changes (push your branch first, then rebuild)

Action scripts are not built into OCI artifacts and stored in a container registry but rather are stored in the Nuon data plane and retrieved during an install workflow step.

DOCS