{
  "$schema": "https://degreesofsatoshi.com/encyclopedia/schemas/article-v1.json",
  "schemaVersion": "1.0.0",
  "id": "bitcoin-software-upgrades",
  "canonical": "https://degreesofsatoshi.com/encyclopedia/bitcoin-software-upgrades/",
  "collection": "bitcoin",
  "title": "Updating Bitcoin software: releases, backups and compatibility",
  "description": "Plan a Bitcoin software update around authentic releases, usable backups and wallet or API compatibility rather than assuming installation changes the network rules.",
  "aliases": [
    "update bitcoin core safely",
    "update bitcoin core safely explained"
  ],
  "dates": {
    "published": "2026-10-02",
    "modified": "2026-10-02",
    "verified": "2026-10-02T19:29:20.637Z",
    "dataAsOf": "2026-10-02"
  },
  "authorship": {
    "publisher": "Degrees of Satoshi editorial project",
    "process": "AI-assisted research and drafting with a separate automated source-verification pass; no external expert or named human review is implied."
  },
  "quickAnswer": {
    "text": "Updating Bitcoin software replaces a local implementation. It can bring security fixes and compatibility changes, but installing a release is not itself a vote that forces everyone else to change consensus rules. Obtain the authentic release, read its migration notes, preserve the wallet’s required backups and confirm the node and wallet state afterward. Downgrading can be unsafe when a new release changes stored formats.",
    "claimId": "bitcoin-software-upgrades-quick-answer",
    "sourceIds": [
      "x425-btc-secure",
      "x425-btc-core-download",
      "x425-btc-electrum-faq",
      "x425-btc-core-rpc",
      "x425-btc-dev-block-chain"
    ]
  },
  "keyFacts": [
    {
      "label": "Release check",
      "value": "Verify the exact downloaded package",
      "sourceIds": [
        "x425-btc-core-download"
      ],
      "id": "release-check",
      "claimId": "bitcoin-software-upgrades-fact-release-check"
    },
    {
      "label": "Backup scope",
      "value": "Preserve all required wallet recovery data",
      "sourceIds": [
        "x425-btc-secure"
      ],
      "id": "backup-scope",
      "claimId": "bitcoin-software-upgrades-fact-backup-scope"
    },
    {
      "label": "Compatibility",
      "value": "Wallet and RPC formats can change",
      "sourceIds": [
        "x425-btc-electrum-faq",
        "x425-btc-core-rpc"
      ],
      "id": "compatibility",
      "claimId": "bitcoin-software-upgrades-fact-compatibility"
    }
  ],
  "prerequisites": [
    "bitcoin-improvement-proposals",
    "soft-forks-and-hard-forks"
  ],
  "sections": [
    {
      "id": "before",
      "heading": "Separate the executable from irreplaceable data",
      "sourceIds": [
        "x425-btc-core-files",
        "x425-btc-secure",
        "x425-btc-core-rpc"
      ],
      "paragraphs": [
        "Core’s blocks, chainstate and wallet files serve different purposes. Chain data can often be downloaded or rebuilt; missing private keys cannot be recreated that way. Identify the wallet’s supported backup method before changing the software around it.",
        "Record the current release, network and application integrations. A dashboard may depend on an RPC field or behavior that a newer major version changes."
      ]
    },
    {
      "id": "upgrade",
      "heading": "Follow the release’s documented path",
      "sourceIds": [
        "x425-btc-core-download",
        "x425-btc-core-rpc",
        "x425-btc-electrum-faq"
      ],
      "paragraphs": [
        "Verify the release package and consult the project’s upgrade notes. Core documents major-version changes and temporary deprecated-RPC options. Electrum warns that opening a wallet in a newer version can change its file format, so blindly reinstalling an older executable may not reverse the update.",
        "For an illustrative upgrade rehearsal, confirm the wallet opens, expected receiving information matches and the node reports the intended chain. A successful installer alone establishes none of those outcomes."
      ]
    },
    {
      "id": "after",
      "heading": "Check operational behavior and recovery assumptions",
      "sourceIds": [
        "x425-btc-core-getblockchaininfo",
        "x425-btc-core-getnetworkinfo",
        "x425-btc-secure"
      ],
      "paragraphs": [
        "Verify synchronization and connectivity, then check wallet history and the relevant integrations. If something differs, preserve the evidence and use the project’s documented recovery path rather than deleting files to make warnings disappear.",
        "Do not interpret every new feature as active on every wallet, peer or network. Implementation support, local configuration and protocol deployment are separate facts."
      ]
    }
  ],
  "faq": [
    {
      "question": "Can I always downgrade after opening a wallet with a newer version?",
      "answer": "No. A newer release may change wallet-file format or other stored data. Electrum explicitly warns that older versions may not read updated files. Consult the particular product’s compatibility notes and backups.",
      "sourceIds": [
        "x425-btc-electrum-faq"
      ]
    },
    {
      "question": "Should an update ever ask a website for my seed phrase?",
      "answer": "A software download or signature check does not require the secrets controlling your funds. Follow the wallet’s documented local recovery process when recovery is actually needed, and keep recovery material away from untrusted websites.",
      "sourceIds": [
        "x425-btc-secure",
        "x425-btc-core-download"
      ]
    }
  ],
  "claims": [
    {
      "id": "bitcoin-software-upgrades-quick-answer",
      "articleSlug": "bitcoin-software-upgrades",
      "statement": "Updating Bitcoin software replaces a local implementation. It can bring security fixes and compatibility changes, but installing a release is not itself a vote that forces everyone else to change consensus rules. Obtain the authentic release, read its migration notes, preserve the wallet’s required backups and confirm the node and wallet state afterward. Downgrading can be unsafe when a new release changes stored formats.",
      "sourceIds": [
        "source-ccf126c494bfe748",
        "source-4530aa79056687e5",
        "source-82375415e215e2f2",
        "source-84123e4e42fca415",
        "source-190b9fe0eec933dc"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-ccf126c494bfe748",
          "locator": "Be careful with online services; Backup your wallet; Encrypt your wallet; Offline wallet for savings; Hardware wallets; Keep your software up to date"
        },
        {
          "sourceId": "source-4530aa79056687e5",
          "locator": "Verify your download"
        },
        {
          "sourceId": "source-82375415e215e2f2",
          "locator": "Does Electrum trust servers?; Can I import private keys from other Bitcoin clients?; Can I sweep private keys from other Bitcoin clients?; What is the gap limit?; How do I upgrade Electrum?"
        },
        {
          "sourceId": "source-84123e4e42fca415",
          "locator": "Introduction; Endpoints; Versioning; Security; RPC consistency guarantees"
        },
        {
          "sourceId": "source-190b9fe0eec933dc",
          "locator": "Block Height And Forking; Transaction Data; Proof Of Work; Consensus Rule Changes"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "Educational explanation. Product-specific behavior is scoped to the cited documentation, checked 2026-10-02.",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Checked authentic-package process, Core major-version RPC/deprecation rules and Electrum wallet-format downgrade warning. Added direct source support for local software replacement versus network consensus and for integration compatibility checks."
        ]
      }
    },
    {
      "id": "bitcoin-software-upgrades-fact-release-check",
      "articleSlug": "bitcoin-software-upgrades",
      "statement": "Release check: Verify the exact downloaded package",
      "sourceIds": [
        "source-4530aa79056687e5"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-4530aa79056687e5",
          "locator": "Verify your download"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Checked authentic-package process, Core major-version RPC/deprecation rules and Electrum wallet-format downgrade warning. Added direct source support for local software replacement versus network consensus and for integration compatibility checks."
        ]
      }
    },
    {
      "id": "bitcoin-software-upgrades-fact-backup-scope",
      "articleSlug": "bitcoin-software-upgrades",
      "statement": "Backup scope: Preserve all required wallet recovery data",
      "sourceIds": [
        "source-ccf126c494bfe748"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-ccf126c494bfe748",
          "locator": "Be careful with online services; Backup your wallet; Encrypt your wallet; Offline wallet for savings; Hardware wallets; Keep your software up to date"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Checked authentic-package process, Core major-version RPC/deprecation rules and Electrum wallet-format downgrade warning. Added direct source support for local software replacement versus network consensus and for integration compatibility checks."
        ]
      }
    },
    {
      "id": "bitcoin-software-upgrades-fact-compatibility",
      "articleSlug": "bitcoin-software-upgrades",
      "statement": "Compatibility: Wallet and RPC formats can change",
      "sourceIds": [
        "source-82375415e215e2f2",
        "source-84123e4e42fca415"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-82375415e215e2f2",
          "locator": "Does Electrum trust servers?; Can I import private keys from other Bitcoin clients?; Can I sweep private keys from other Bitcoin clients?; What is the gap limit?; How do I upgrade Electrum?"
        },
        {
          "sourceId": "source-84123e4e42fca415",
          "locator": "Introduction; Endpoints; Versioning; Security; RPC consistency guarantees"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Checked authentic-package process, Core major-version RPC/deprecation rules and Electrum wallet-format downgrade warning. Added direct source support for local software replacement versus network consensus and for integration compatibility checks."
        ]
      }
    }
  ],
  "sources": [
    {
      "id": "x425-btc-secure",
      "label": "Securing your wallet",
      "publisher": "Bitcoin.org",
      "url": "https://bitcoin.org/en/secure-your-wallet",
      "locator": "Be careful with online services; Backup your wallet; Encrypt your wallet; Offline wallet for savings; Hardware wallets; Keep your software up to date",
      "note": "Backup scope, online exposure, offline signing, custody and software update practices.",
      "checkedAt": "2026-10-02T18:53:53.659Z",
      "contentSha256": "b6017f869461de2150d6b3b328f2ff75aedcd888d7a66cc311acbc243d6ead49",
      "recordId": "source-ccf126c494bfe748",
      "version": null
    },
    {
      "id": "x425-btc-core-download",
      "label": "Download Bitcoin Core",
      "publisher": "Bitcoin Core",
      "url": "https://bitcoincore.org/en/download/",
      "locator": "Verify your download",
      "note": "Current official distribution and binary verification instructions; do not infer third-party package safety.",
      "checkedAt": "2026-10-02T18:53:56.631Z",
      "contentSha256": "ce4ad6a91e072cc4a9c6b2f4c02aa376f6c1cdf8bd616463601dbe79e908db4a",
      "recordId": "source-4530aa79056687e5",
      "version": null
    },
    {
      "id": "x425-btc-electrum-faq",
      "label": "Frequently Asked Questions",
      "publisher": "Electrum",
      "url": "https://electrum.readthedocs.io/en/latest/faq.html",
      "locator": "Does Electrum trust servers?; Can I import private keys from other Bitcoin clients?; Can I sweep private keys from other Bitcoin clients?; What is the gap limit?; How do I upgrade Electrum?",
      "note": "Electrum-specific sweep/import distinctions, seed recovery scope and address discovery.",
      "checkedAt": "2026-10-02T18:53:56.378Z",
      "contentSha256": "a7f9a2d109a2a753b0010cda1bd2d789a0417a0788a48ea6632c3fe3b391fb06",
      "recordId": "source-82375415e215e2f2",
      "version": null
    },
    {
      "id": "x425-btc-core-rpc",
      "label": "JSON-RPC interface",
      "publisher": "Bitcoin Core",
      "url": "https://raw.githubusercontent.com/bitcoin/bitcoin/v29.0/doc/JSON-RPC-interface.md",
      "locator": "Introduction; Endpoints; Versioning; Security; RPC consistency guarantees",
      "note": "Privileged RPC scope, authentication, local access and unencrypted transport limitations.",
      "version": "Bitcoin Core v29.0",
      "checkedAt": "2026-10-02T18:53:55.910Z",
      "contentSha256": "c56badff1616ff19b112ebbc97d600726101ca8e8fa2c91b15b901b96c938930",
      "recordId": "source-84123e4e42fca415"
    },
    {
      "id": "x425-btc-dev-block-chain",
      "label": "Block Chain",
      "publisher": "Bitcoin developer documentation",
      "url": "https://developer.bitcoin.org/devguide/block_chain.html",
      "locator": "Block Height And Forking; Transaction Data; Proof Of Work; Consensus Rule Changes",
      "note": "Chain validation, block timing, proof of work and accepted-chain context.",
      "version": "Developer guide; historical implementation details require qualification",
      "checkedAt": "2026-10-02T18:53:53.957Z",
      "contentSha256": "4d0bca201a3d75bf36bcf1d22e756ef6f25fe72c522d62c79a355b65a0f1ce1b",
      "recordId": "source-190b9fe0eec933dc"
    },
    {
      "id": "x425-btc-core-files",
      "label": "Files",
      "publisher": "Bitcoin Core",
      "url": "https://raw.githubusercontent.com/bitcoin/bitcoin/v29.0/doc/files.md",
      "locator": "Data directory location and chain-specific paths; Data directory layout: blocks/, chainstate/, wallets/; Multi-wallet environment and backupwallet guidance",
      "note": "Wallet, block, chainstate and index files have different recovery purposes.",
      "version": "Bitcoin Core v29.0",
      "checkedAt": "2026-10-02T18:53:55.926Z",
      "contentSha256": "b22521efd202f947f5a126bb1f8bf24b1f03e48c3cc7928d3d5d11c53e2657b4",
      "recordId": "source-49ac1d73e9642790"
    },
    {
      "id": "x425-btc-core-getblockchaininfo",
      "label": "getblockchaininfo RPC",
      "publisher": "Bitcoin Core",
      "url": "https://bitcoincore.org/en/doc/29.0.0/rpc/blockchain/getblockchaininfo/",
      "locator": "Result: chain, blocks, headers, verificationprogress, initialblockdownload",
      "note": "Network identity and sync-status fields; progress is an estimate.",
      "version": "Bitcoin Core 29.0 RPC reference; not a recommendation to install an old release",
      "checkedAt": "2026-10-02T18:53:55.851Z",
      "contentSha256": "1606375ff762737f95c646b1acc42138eff69ce22d6490aca60f054dedf97ef1",
      "recordId": "source-961282fbeb6f3ea6"
    },
    {
      "id": "x425-btc-core-getnetworkinfo",
      "label": "getnetworkinfo RPC",
      "publisher": "Bitcoin Core",
      "url": "https://bitcoincore.org/en/doc/29.0.0/rpc/network/getnetworkinfo/",
      "locator": "Result: connections, connections_in, connections_out, networkactive, networks, localaddresses, warnings",
      "note": "Peer connections and network reachability state.",
      "version": "Bitcoin Core 29.0 RPC reference; not a recommendation to install an old release",
      "checkedAt": "2026-10-02T18:53:55.860Z",
      "contentSha256": "2ff59403274dd4f98fa422411e2b59350b52736e7b89efdd7e27ca6214fbf610",
      "recordId": "source-ac189ce0cbbe1a69"
    }
  ],
  "related": {
    "articles": [
      "bitcoin-improvement-proposals",
      "soft-forks-and-hard-forks",
      "private-keys-and-seed-phrases",
      "bitcoin-node-rpc-security",
      "bitcoin-transaction-broadcasting"
    ],
    "dossiers": [],
    "wallets": []
  },
  "revisionHistory": [
    {
      "date": "2026-10-02",
      "kind": "published",
      "summary": "First publication after primary-source research and separate automated verification."
    }
  ],
  "citation": "Degrees of Satoshi editorial project. “Updating Bitcoin software: releases, backups and compatibility.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/bitcoin-software-upgrades/"
}