nf

Sync

nf env push and nf env pull sync the database and mutable wp-content between the local env and a configured repo remote.

Database and uploads sync are high risk. Treat every production push as potentially destructive.

Direction

Pull remote data into local development:

nf env pull production --dry-run

Push local data to a remote env:

nf env push production --dry-run

If you omit the remote, nf prompts you to choose from configured repo remotes:

nf env pull --dry-run

In non-interactive mode, provide the remote explicitly.

What Sync Moves

Sync includes:

• database
• wp-content/uploads
• wp-content/plugins
• wp-content/mu-plugins
• wp-content/languages

Theme deployment is separate. Use Themes for theme releases.

Review Before Execution

Dry-run prints the local project, local env path, remote name, site, env, provider, URL, access summary, and mode:

nf env pull production --dry-run
nf env push production --dry-run

No data is changed in dry-run mode.

Non-interactive preflight without execution is also non-mutating:

nf env pull production --non-interactive

Execute a Sync

Interactive execution prompts for confirmation:

nf env pull production
nf env push production

Non-interactive execution requires both --execute and --yes:

nf env pull production --execute --yes --non-interactive
nf env push production --execute --yes --non-interactive

Safety Checklist

Before pulling remote data into local:

• Confirm the remote points at the intended env with nf remote show <remote>.
• Create a local snapshot if you may need to restore current local work.
• Use --dry-run and read the plan.

Before pushing local data to a remote:

• Confirm the remote is not production unless production overwrite is intended.
• Confirm stakeholders understand this syncs the database and mutable wp-content.
• Create or verify a recoverable snapshot of the destination env.
• Use --dry-run and read the plan.
• Execute only when the source and destination are explicit and correct.

Key rule: never silently clobber production credentials or content.