1# Deploy Configuration
2
3Controls how Gordon pulls images during deployment.
4
5## Example
6
7```toml
8[deploy]
9pull_policy = "if-tag-changed"
10```
11
12## Settings
13
14### `deploy.pull_policy`
15
16How to decide when to pull an image:
17
18- `always`: always pull, even if the tag exists locally.
19- `if-not-present`: only pull when the tag is missing locally.
20- `if-tag-changed`: pull for tag references to check for updates; skip pulls for digest references (`@sha256:...`).
21
22Default: `if-tag-changed`
23
24## Notes
25
26- Changes to `deploy.pull_policy` require a restart to take effect.