Skip to content
Keboola Docs

Pull Command

Sync a project to the local directory.

kbc sync pull [flags]

Or shorter:

kbc pull [flags]
kbc pl [flags]

Local changes will be overwritten to match the state of the project.

If your local state is invalid, the command will fail unless you use the --force flag.

--dry-run : Preview all changes

--force : Ignore invalid local state

--cleanup-rename-conflicts : Enable cleanup mode for handling rename conflicts. When configurations are renamed in the UI (e.g., in a chain like A→B, C→A), this option removes conflicting destinations to allow the rename to proceed. Only use this for UI-only workflows where changes are made exclusively in the Keboola UI and synced down. This option is not needed for normal Git-based development workflows.

Global Options

➜ kbc pull --dry-run
Pulling objects to the local directory.
Plan for "pull" operation:
× C main/extractor/keboola.ex-db-mysql/7511990/invoices
× R main/extractor/keboola.ex-db-mysql/7511990/invoices/rows/customer
Pull done.
Ask Kai

Ask anything about Keboola — I'll search the docs and cite the pages I use.