Skip to content

state pull

Download the raw state payload from the configured state store, exactly as stored. Where state show renders the recorded schema for reading, pull downloads the payload for backup, inspection with your own tools, or hand-editing before a state push.

Terminal window
nschema state pull # write the payload to stdout
nschema state pull ./backup.json # write the payload to a file

Without a file argument the payload is written to standard output with no other narration:

Terminal window
nschema state pull > backup.json

Pull never interprets the payload, so state that has become unreadable (a corrupt or truncated payload) can still be pulled for repair; fix it by hand, and push it back.

  • file (optional) — write the payload to this file instead of standard output.