Where Is the Skaffold Config File?
Skaffold reads skaffold.yaml at the project root, naming build artifacts and deploy targets per profile.
Last updated
Skaffold configures from a YAML file at the project root. The skaffold.yaml file lists build artifacts, tag policy, and deploy targets with profiles per environment. Modules split large setups across files it includes.
Schema versions with the binary, so match the apiVersion to your install. Init scaffolds a starter file from existing manifests. Keep the file beside the Dockerfiles and manifests it drives.
Where Skaffold stores this, by platform
[ProjectDir]/skaffold.yaml
Artifacts, profiles, and deploy targets live here. Modules split files by service. Match apiVersion to the binary version.
[ProjectDir]/skaffold.yaml
Same root file on Mac. File sync rules keep dev loops fast. Profiles switch clusters per command flag.
[ProjectDir]\skaffold.yaml
Same file on Windows. Path handling inside follows the project root. Exact schema keys vary by Skaffold release.
Frequently asked questions
How do I handle several environments?
Add profiles in skaffold.yaml overriding deploy targets per name. Activate with the profile flag per run. Keep defaults safe for local dev.
Why does Skaffold reject my config?
The apiVersion predates the binary or a key moved. Run fix to migrate schemas forward. Pin the binary version in CI.
Notice an outdated path? Let us know.