Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.
Day-to-day operations for a running Whitechain RPC node: start and stop commands, datadir backups, upgrades, and security practices.
Operate the node
Generic targets take PROFILE=full-snap-node|full-node|archive-node (default full-snap-node):
make up PROFILE=archive-node # startmake down PROFILE=archive-node # stopmake reup PROFILE=archive-node # down + upmake ps PROFILE=archive-node # statusmake logs PROFILE=archive-node # tail logsmake config PROFILE=archive-node # render merged compose config
Per-profile shortcuts exist for each, for example make up-full-snap-node, make logs-archive-node, make reup-full-node. make ensure-jwt generates keys/<profile>/jwt.txt manually, and make help lists every target.
Restore from a published snapshot
Whitechain publishes crash-consistent snapshots of a full (non-archive) op-reth datadir. A snapshot fits the full-node profile only: it cannot serve archive queries, so archive-node still syncs from genesis.
https://snapshots.whitechain.io, with the first snapshot taken right after genesis
Published on that host
latest.json names the newest archive and carries its url, sha256, size_bytes, date, chain_id, and block_height. Each archive is a tar file compressed with zstd, named whitechain-testnet-op-reth-YYYY-MM-DD.tar.zst, with a .sha256 file next to it.
Stop the profile and replace its op-reth datadir with the snapshot.
make down PROFILE=full-noderm -rf data/full-node/op-rethmkdir -p data/full-node/op-rethzstd -d --stdout whitechain-testnet-op-reth-YYYY-MM-DD.tar.zst | tar -x -C data/full-node/op-reth
Start the profile. The node replays the tail after the snapshot block from L1 and syncs to the head.
make up PROFILE=full-node
Back up and restore the datadir
You can also keep is your own backup of a full-node or archive-node datadir, so a disk failure or a corrupted database does not cost you a full resync from genesis. Back up only the op-reth data; the op-node directory (peerstore, discovery, safedb) rebuilds itself.
Stop the node to get a consistent on-disk database.
make down PROFILE=full-node
Archive and compress the op-reth datadir (db, static_files, and related folders).
tar -c -C data/full-node/op-reth . | zstd -o op-reth-testnet-full.tar.zst
Restart the node so it resumes following the chain.
make up PROFILE=full-node
To restore: stop the profile, replace data/<profile>/op-reth with the extracted archive, and start the profile again. The node derives everything after the backup point from L1 and catches up the unsafe head over P2P, so it still needs a working L1 RPC and Beacon.A backup only fits the profile it was taken from: a pruned (full-node) datadir cannot serve archive queries. Keep the network and the profile in the archive name.
Update the node
op-reth and op-node image versions are pinned in docker-compose.yml, and OP_RETH_IMAGE and OP_NODE_IMAGE in .env override the pin. To upgrade:
The Whitechain team announces hardforks in advance. If an upgrade includes a hardfork, pull the new rollup.json (and genesis.json if it changed) from whitechain-bootstrap, check it against the SHA-256 hashes published there, copy it into artifacts/<network>/, and only then run make reup. The published hashes change whenever a hardfork changes the artifacts, so verify again on every such update. Apply the new artifacts before the activation timestamp to avoid a chain-divergence stall. See Network artifacts.
Wipe and resync from genesis
To wipe local state and resync a profile from genesis, run make down PROFILE=<profile>, then rm -rf data/<profile>/op-reth data/<profile>/op-node, then make up PROFILE=<profile>.
This deletes the local chain database for that profile. On full-node and archive-node the next start re-executes the chain from genesis, so do not run this against a production node without a maintenance window. Restoring your own backup is the cheaper recovery when you have one.
Security
The Engine API on 8551 stays on the profile’s own Compose network (public_rpc_full_snap, public_rpc_full, or public_rpc_archive) and is never published to the host.
op-node RPC on 9545 is bound to loopback (127.0.0.1) only, on every profile, so it is reachable from the host but never from the network. The admin namespace is not enabled, so it serves only the read-only optimism, superroot, and opp2p namespaces.
op-reth exposes no admin namespace on any profile. The public JSON-RPC (8545) and WebSocket (8546) ports serve only read-only namespaces, by default eth, net, web3, and rpc on every profile, archive-node included. debug, trace, txpool, and reth are off unless you add them to HTTP_API or WS_API. They are read-only too, but expensive enough to be a denial-of-service vector, so put a method-allowlisting, rate-limiting proxy in front before enabling them. See RPC namespaces.
On full-snap-node the EL P2P port 30303 is published on all interfaces, TCP and UDP, because op-reth needs it to snap-sync and to peer over devp2p. It carries no RPC and no administrative methods. full-node and archive-node do not publish it.
keys/<profile>/jwt.txt is generated locally and used only between the op-node and op-reth of that profile. Each profile has its own secret and its own Compose network, so one profile’s Engine API credential never grants access to another’s. It does not need to match anything outside. If you upgraded from a version that used a single keys/jwt.txt, the next make up generates the per-profile secret and recreates both containers with it, and the old file can be deleted.
The node holds no project-side private keys. Operate it as a read-and-forward node.
Restrict inbound access to the JSON-RPC ports you choose to expose. Put them behind a firewall, reverse proxy, or rate limiter before serving untrusted clients.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Whitechain","description":"Whitechain is an EVM-compatible OP Stack Layer 2 settling on Ethereum, with WBT as the native gas token.","colors":{"primary":"#0066FF","light":"#0066FF","dark":"#0066FF"},"logo":{"light":"https://mintcdn.com/whitechain/o8RSRL0ALt-fVo2n/img/logo_light.png?fit=max\u0026auto=format\u0026n=o8RSRL0ALt-fVo2n\u0026q=85\u0026s=d8f2337bf2c14666a6f660dec4dd8d8d","dark":"https://mintcdn.com/whitechain/o8RSRL0ALt-fVo2n/img/logo_dark.png?fit=max\u0026auto=format\u0026n=o8RSRL0ALt-fVo2n\u0026q=85\u0026s=bbefd2aacc4e39b9c9258507d7789aa2","href":"/"},"favicon":"https://mintcdn.com/whitechain/3a0MoncCUeiueyFt/favicon.png?fit=max\u0026auto=format\u0026n=3a0MoncCUeiueyFt\u0026q=85\u0026s=241a254f11075382e440d9a5239a01fb","appearance":{"default":"system"},"background":{"decoration":"gradient","color":{"light":"#F8FAFC","dark":"#07081E"}},"navbar":{"links":[{"href":"https://t.me/Whitechain_io","label":"Support"}]},"footer":{"socials":{"website":"https://whitechain.io","x":"https://x.com/Whitechain_io","github":"https://github.com/whitechain-labs","discord":"https://discord.gg/7GwAXYmaW9","telegram":"https://t.me/whitechain_news_io"}},"fonts":{"heading":{"family":"Roboto","weight":600},"body":{"family":"Inter","weight":400}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"variables":{"WEBSITE_URL":"https://whitechain.io","DOCS_URL":"https://docs.whitechain.io","EXPLORER_TESTNET_URL":"https://explorer.testnet.whitechain.io","EXPLORER_MAINNET_URL":"https://explorer.whitechain.io","FAUCET_TESTNET_URL":"https://faucet.testnet.whitechain.io","RPC_TESTNET_URL":"https://rpc.testnet.whitechain.io","RPC_TESTNET_WSS":"wss://rpc.testnet.whitechain.io/ws","WBT_COINGECKO_URL":"https://www.coingecko.com/en/coins/whitebit"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"signal","href":"https://status.whitechain.io"},{"anchor":"Faucet","icon":"droplet","href":"https://faucet.testnet.whitechain.io"},{"anchor":"Bridge","icon":"arrow-left-right","href":"https://bridge.whitechain.io"},{"anchor":"Explorer","icon":"compass","href":"https://explorer.whitechain.io"},{"anchor":"Blog","icon":"newspaper","href":"https://whitechain.io/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"whitechain","hasAudioNarration":false,"actualSubdomain":"whitechain","customDomains":["docs.whitechain.io"],"gitSource":{"type":"github","owner":"whitechainio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb07ca14079de35bcd37ca","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Build","count":19},{"language":"default","tag":"Learn","count":14},{"language":"default","tag":"Operate","count":8},{"language":"default","tag":"Run a Node","count":6},{"language":"default","tag":"Block Explorer","count":5},{"language":"default","tag":"Network","count":5},{"language":"default","tag":"Bridge","count":4},{"language":"default","tag":"Dapps","count":4},{"language":"default","tag":"Deploy","count":4},{"language":"default","tag":"General","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".sidebar-group-header{font-size:1rem;font-weight:700;letter-spacing:0.01em}#sidebar-content ul li,#sidebar-content [role=\"list\"] li{padding-left:0.75rem}#sidebar-content .sidebar-group-header{padding-left:0}html:not(.dark) .mdx-content strong,html:not(.dark) .mdx-content b{color:#000000!important;font-weight:700!important}html.dark .mdx-content strong,html.dark .mdx-content b{color:#ffffff!important;font-weight:800!important}"}],"page":{"pagePath":"operate/run-a-node/maintenance","slug":"/operate/run-a-node/maintenance","pageMetadata":{"title":"Node maintenance","description":"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.","keywords":["maintenance","operate","update","backup","restore","upgrade","hardfork","security","Whitechain"],"href":"/operate/run-a-node/maintenance"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Day-to-day operations for a running Whitechain RPC node: start and stop commands, datadir backups, upgrades, and security practices.`}),`\n`,_jsx(Heading,{level:`2`,id:`operate-the-node`,children:`Operate the node`}),`\n`,_jsxs(_components.p,{children:[`Generic targets take `,_jsx(_components.code,{children:`PROFILE=full-snap-node|full-node|archive-node`}),` (default `,_jsx(_components.code,{children:`full-snap-node`}),`):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` up`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=archive-node`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # start`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` down`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=archive-node`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # stop`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` reup`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=archive-node`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # down + up`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ps`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=archive-node`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # status`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` logs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=archive-node`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # tail logs`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=archive-node`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # render merged compose config`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Per-profile shortcuts exist for each, for example `,_jsx(_components.code,{children:`make up-full-snap-node`}),`, `,_jsx(_components.code,{children:`make logs-archive-node`}),`, `,_jsx(_components.code,{children:`make reup-full-node`}),`. `,_jsx(_components.code,{children:`make ensure-jwt`}),` generates `,_jsx(_components.code,{children:`keys/\u003cprofile>/jwt.txt`}),` manually, and `,_jsx(_components.code,{children:`make help`}),` lists every target.`]}),`\n`,_jsx(Heading,{level:`2`,id:`restore-from-a-published-snapshot`,children:`Restore from a published snapshot`}),`\n`,_jsxs(_components.p,{children:[`Whitechain publishes crash-consistent snapshots of a full (non-archive) `,_jsx(_components.code,{children:`op-reth`}),` datadir. A snapshot fits the `,_jsx(_components.code,{children:`full-node`}),` profile only: it cannot serve archive queries, so `,_jsx(_components.code,{children:`archive-node`}),` still syncs from genesis.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Network`}),_jsx(_components.th,{children:`Snapshot index`}),_jsx(_components.th,{children:`Latest snapshot metadata`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Whitechain Sepolia`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`https://snapshots.testnet.whitechain.io/testnet/index.html`,children:`snapshots.testnet.whitechain.io/testnet`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://snapshots.testnet.whitechain.io/testnet/latest.json`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Whitechain Mainnet`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`https://snapshots.whitechain.io`}),`, with the first snapshot taken right after genesis`]}),_jsx(_components.td,{children:`Published on that host`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`latest.json`}),` names the newest archive and carries its `,_jsx(_components.code,{children:`url`}),`, `,_jsx(_components.code,{children:`sha256`}),`, `,_jsx(_components.code,{children:`size_bytes`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`chain_id`}),`, and `,_jsx(_components.code,{children:`block_height`}),`. Each archive is a tar file compressed with zstd, named `,_jsx(_components.code,{children:`whitechain-testnet-op-reth-YYYY-MM-DD.tar.zst`}),`, with a `,_jsx(_components.code,{children:`.sha256`}),` file next to it.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Read the latest snapshot metadata.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://snapshots.testnet.whitechain.io/testnet/latest.json`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Download the archive from the `,_jsx(_components.code,{children:`url`}),` field, then compare its hash with the `,_jsx(_components.code,{children:`sha256`}),` field. Do not extract an archive whose hash differs.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fLO`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://snapshots.testnet.whitechain.io/testnet/whitechain-testnet-op-reth-YYYY-MM-DD.tar.zst`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sha256sum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` whitechain-testnet-op-reth-YYYY-MM-DD.tar.zst`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Stop the profile and replace its `,_jsx(_components.code,{children:`op-reth`}),` datadir with the snapshot.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` down`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=full-node`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`rm`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -rf`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` data/full-node/op-reth`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mkdir`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -p`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` data/full-node/op-reth`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`zstd`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --stdout`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` whitechain-testnet-op-reth-YYYY-MM-DD.tar.zst`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` tar`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -x`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -C`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` data/full-node/op-reth`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Start the profile. The node replays the tail after the snapshot block from L1 and syncs to the head.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` up`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=full-node`})]}),`\n`]})})}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`back-up-and-restore-the-datadir`,children:`Back up and restore the datadir`}),`\n`,_jsxs(_components.p,{children:[`You can also keep is your own backup of a `,_jsx(_components.code,{children:`full-node`}),` or `,_jsx(_components.code,{children:`archive-node`}),` datadir, so a disk failure or a corrupted database does not cost you a full resync from genesis. Back up only the `,_jsx(_components.code,{children:`op-reth`}),` data; the `,_jsx(_components.code,{children:`op-node`}),` directory (`,_jsx(_components.code,{children:`peerstore`}),`, `,_jsx(_components.code,{children:`discovery`}),`, `,_jsx(_components.code,{children:`safedb`}),`) rebuilds itself.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Stop the node to get a consistent on-disk database.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` down`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=full-node`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Archive and compress the `,_jsx(_components.code,{children:`op-reth`}),` datadir (`,_jsx(_components.code,{children:`db`}),`, `,_jsx(_components.code,{children:`static_files`}),`, and related folders).`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`tar`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -c`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -C`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` data/full-node/op-reth`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` zstd`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` op-reth-testnet-full.tar.zst`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Restart the node so it resumes following the chain.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` up`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=full-node`})]}),`\n`]})})}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`To restore: stop the profile, replace `,_jsx(_components.code,{children:`data/\u003cprofile>/op-reth`}),` with the extracted archive, and start the profile again. The node derives everything after the backup point from L1 and catches up the unsafe head over P2P, so it still needs a working L1 RPC and Beacon.`]}),`\n`,_jsxs(_components.p,{children:[`A backup only fits the profile it was taken from: a pruned (`,_jsx(_components.code,{children:`full-node`}),`) datadir cannot serve archive queries. Keep the network and the profile in the archive name.`]}),`\n`,_jsx(Heading,{level:`2`,id:`update-the-node`,children:`Update the node`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`op-reth`}),` and `,_jsx(_components.code,{children:`op-node`}),` image versions are pinned in `,_jsx(_components.code,{children:`docker-compose.yml`}),`, and `,_jsx(_components.code,{children:`OP_RETH_IMAGE`}),` and `,_jsx(_components.code,{children:`OP_NODE_IMAGE`}),` in `,_jsx(_components.code,{children:`.env`}),` override the pin. To upgrade:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pull`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` compose`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pull`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`make`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` reup`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PROFILE=full-snap-node`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The Whitechain team announces hardforks in advance. If an upgrade includes a hardfork, pull the new `,_jsx(_components.code,{children:`rollup.json`}),` (and `,_jsx(_components.code,{children:`genesis.json`}),` if it changed) from `,_jsx(_components.a,{href:`https://github.com/whitechain-labs/whitechain-bootstrap`,children:`whitechain-bootstrap`}),`, check it against the SHA-256 hashes published there, copy it into `,_jsx(_components.code,{children:`artifacts/\u003cnetwork>/`}),`, and only then run `,_jsx(_components.code,{children:`make reup`}),`. The published hashes change whenever a hardfork changes the artifacts, so verify again on every such update. Apply the new artifacts before the activation timestamp to avoid a chain-divergence stall. See `,_jsx(_components.a,{href:`/operate/run-a-node/network-artifacts`,children:`Network artifacts`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`wipe-and-resync-from-genesis`,children:`Wipe and resync from genesis`}),`\n`,_jsxs(_components.p,{children:[`To wipe local state and resync a profile from genesis, run `,_jsx(_components.code,{children:`make down PROFILE=\u003cprofile>`}),`, then `,_jsx(_components.code,{children:`rm -rf data/\u003cprofile>/op-reth data/\u003cprofile>/op-node`}),`, then `,_jsx(_components.code,{children:`make up PROFILE=\u003cprofile>`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`This deletes the local chain database for that profile. On `,_jsx(_components.code,{children:`full-node`}),` and `,_jsx(_components.code,{children:`archive-node`}),` the next start re-executes the chain from genesis, so do not run this against a production node without a maintenance window. Restoring your own backup is the cheaper recovery when you have one.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`security`,children:`Security`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The Engine API on `,_jsx(_components.code,{children:`8551`}),` stays on the profile’s own Compose network (`,_jsx(_components.code,{children:`public_rpc_full_snap`}),`, `,_jsx(_components.code,{children:`public_rpc_full`}),`, or `,_jsx(_components.code,{children:`public_rpc_archive`}),`) and is never published to the host.`]}),`\n`,_jsxs(_components.li,{children:[`op-node RPC on `,_jsx(_components.code,{children:`9545`}),` is bound to loopback (`,_jsx(_components.code,{children:`127.0.0.1`}),`) only, on every profile, so it is reachable from the host but never from the network. The `,_jsx(_components.code,{children:`admin`}),` namespace is not enabled, so it serves only the read-only `,_jsx(_components.code,{children:`optimism`}),`, `,_jsx(_components.code,{children:`superroot`}),`, and `,_jsx(_components.code,{children:`opp2p`}),` namespaces.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`op-reth`}),` exposes no `,_jsx(_components.code,{children:`admin`}),` namespace on any profile. The public JSON-RPC (`,_jsx(_components.code,{children:`8545`}),`) and WebSocket (`,_jsx(_components.code,{children:`8546`}),`) ports serve only read-only namespaces, by default `,_jsx(_components.code,{children:`eth`}),`, `,_jsx(_components.code,{children:`net`}),`, `,_jsx(_components.code,{children:`web3`}),`, and `,_jsx(_components.code,{children:`rpc`}),` on every profile, `,_jsx(_components.code,{children:`archive-node`}),` included. `,_jsx(_components.code,{children:`debug`}),`, `,_jsx(_components.code,{children:`trace`}),`, `,_jsx(_components.code,{children:`txpool`}),`, and `,_jsx(_components.code,{children:`reth`}),` are off unless you add them to `,_jsx(_components.code,{children:`HTTP_API`}),` or `,_jsx(_components.code,{children:`WS_API`}),`. They are read-only too, but expensive enough to be a denial-of-service vector, so put a method-allowlisting, rate-limiting proxy in front before enabling them. See `,_jsx(_components.a,{href:`/operate/run-a-node/configuration#rpc-namespaces`,children:`RPC namespaces`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`On `,_jsx(_components.code,{children:`full-snap-node`}),` the EL P2P port `,_jsx(_components.code,{children:`30303`}),` is published on all interfaces, TCP and UDP, because `,_jsx(_components.code,{children:`op-reth`}),` needs it to snap-sync and to peer over devp2p. It carries no RPC and no administrative methods. `,_jsx(_components.code,{children:`full-node`}),` and `,_jsx(_components.code,{children:`archive-node`}),` do not publish it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`keys/\u003cprofile>/jwt.txt`}),` is generated locally and used only between the `,_jsx(_components.code,{children:`op-node`}),` and `,_jsx(_components.code,{children:`op-reth`}),` of that profile. Each profile has its own secret and its own Compose network, so one profile’s Engine API credential never grants access to another’s. It does not need to match anything outside. If you upgraded from a version that used a single `,_jsx(_components.code,{children:`keys/jwt.txt`}),`, the next `,_jsx(_components.code,{children:`make up`}),` generates the per-profile secret and recreates both containers with it, and the old file can be deleted.`]}),`\n`,_jsx(_components.li,{children:`The node holds no project-side private keys. Operate it as a read-and-forward node.`}),`\n`,_jsx(_components.li,{children:`Restrict inbound access to the JSON-RPC ports you choose to expose. Put them behind a firewall, reverse proxy, or rate limiter before serving untrusted clients.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/operate/run-a-node/overview`,children:`Node operators overview`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/operate/run-a-node/run-a-node`,children:`Run a node`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/operate/run-a-node/network-artifacts`,children:`Network artifacts`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/operate/run-a-node/configuration`,children:`Node configuration`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/operate/run-a-node/troubleshooting`,children:`Troubleshooting`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Node maintenance","description":"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.","keywords":["maintenance","operate","update","backup","restore","upgrade","hardfork","security","Whitechain"],"href":"/operate/run-a-node/maintenance"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Operate the node","slug":"operate-the-node","depth":2,"children":[]},{"title":"Restore from a published snapshot","slug":"restore-from-a-published-snapshot","depth":2,"children":[]},{"title":"Back up and restore the datadir","slug":"back-up-and-restore-the-datadir","depth":2,"children":[]},{"title":"Update the node","slug":"update-the-node","depth":2,"children":[]},{"title":"Wipe and resync from genesis","slug":"wipe-and-resync-from-genesis","depth":2,"children":[]},{"title":"Security","slug":"security","depth":2,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"whitechain","siteName":"Whitechain","title":"Node maintenance - Whitechain","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T13:35:48.461Z","originalFileLocation":"operate/run-a-node/maintenance.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Whitechain\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Node maintenance - Whitechain\">\u003cmeta data-mint-head property=\"og:description\" content=\"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Whitechain\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.whitechain.io/operate/run-a-node/maintenance\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://whitechain.mintlify.site/_mintlify/api/og/v2?division=Run+a+Node\u0026amp;title=Node+maintenance\u0026amp;description=Operate%2C+back+up%2C+and+update+a+Whitechain+RPC+node%3A+make+targets%2C+datadir+backup+and+restore%2C+the+upgrade+and+hardfork+workflow%2C+and+security+notes.\u0026amp;theme=da2139b9275bf4d49b714427\u0026amp;signature=a6fcf14630f92ea4c336a88edbb14b923d67841e7b105b5c6bf048cd71c9285c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Node maintenance - Whitechain\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://whitechain.mintlify.site/_mintlify/api/og/v2?division=Run+a+Node\u0026amp;title=Node+maintenance\u0026amp;description=Operate%2C+back+up%2C+and+update+a+Whitechain+RPC+node%3A+make+targets%2C+datadir+backup+and+restore%2C+the+upgrade+and+hardfork+workflow%2C+and+security+notes.\u0026amp;theme=da2139b9275bf4d49b714427\u0026amp;signature=a6fcf14630f92ea4c336a88edbb14b923d67841e7b105b5c6bf048cd71c9285c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/whitechain/CG0hu0Bv_FUGydlU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Whitechain\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.whitechain.io/operate/run-a-node/maintenance\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/operate/run-a-node/maintenance.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.whitechain.io/#organization\",\"name\":\"Whitechain\",\"url\":\"https://docs.whitechain.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/whitechain/o8RSRL0ALt-fVo2n/img/logo_light.png?fit=max\u0026auto=format\u0026n=o8RSRL0ALt-fVo2n\u0026q=85\u0026s=d8f2337bf2c14666a6f660dec4dd8d8d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.whitechain.io#website\",\"name\":\"Whitechain\",\"url\":\"https://docs.whitechain.io\",\"publisher\":{\"@id\":\"https://docs.whitechain.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.whitechain.io/operate/run-a-node/maintenance#webpage\",\"url\":\"https://docs.whitechain.io/operate/run-a-node/maintenance\",\"name\":\"Node maintenance\",\"description\":\"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.\",\"dateModified\":\"2026-10-26T13:35:48.461Z\",\"isPartOf\":{\"@id\":\"https://docs.whitechain.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.whitechain.io/operate/run-a-node/maintenance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.whitechain.io/operate/run-a-node/maintenance#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Run a Node\",\"item\":\"https://docs.whitechain.io/operate/run-a-node/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Node maintenance\",\"item\":\"https://docs.whitechain.io/operate/run-a-node/maintenance\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.whitechain.io/operate/run-a-node/maintenance#article\",\"headline\":\"Node maintenance\",\"name\":\"Node maintenance\",\"description\":\"Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.\",\"url\":\"https://docs.whitechain.io/operate/run-a-node/maintenance\",\"mainEntityOfPage\":{\"@id\":\"https://docs.whitechain.io/operate/run-a-node/maintenance#webpage\"},\"dateModified\":\"2026-10-26T13:35:48.461Z\",\"keywords\":\"maintenance, operate, update, backup, restore, upgrade, hardfork, security, Whitechain\",\"publisher\":{\"@id\":\"https://docs.whitechain.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.whitechain.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Whitechain\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Whitechain\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/operate/run-a-node/maintenance.md","siteName":"Whitechain","nav":{"global":{"anchors":[{"anchor":"Status","icon":"signal","href":"https://status.whitechain.io"},{"anchor":"Faucet","icon":"droplet","href":"https://faucet.testnet.whitechain.io"},{"anchor":"Bridge","icon":"arrow-left-right","href":"https://bridge.whitechain.io"},{"anchor":"Explorer","icon":"compass","href":"https://explorer.whitechain.io"},{"anchor":"Blog","icon":"newspaper","href":"https://whitechain.io/blog"}]},"tabs":[{"tab":"Learn","pages":[{"title":"Learn","href":"/learn/introduction"}]},{"tab":"Build","pages":[{"title":"Build","href":"/build/wallet/wallets"}]},{"tab":"Build with AI","pages":[{"title":"Build with AI","href":"/build-with-ai"}]},{"tab":"Operate","groups":[{"group":"Run a Node","icon":"server","pages":[{"title":"Node operators","href":"/operate/run-a-node/overview"},{"title":"Run a node","href":"/operate/run-a-node/run-a-node"},{"title":"Network artifacts","href":"/operate/run-a-node/network-artifacts"},{"title":"Node configuration","description":"Environment variables, network ports, data layout, and RPC limits for Whitechain RPC node profiles.","href":"/operate/run-a-node/configuration"},{"title":"Node maintenance","href":"/operate/run-a-node/maintenance"},{"title":"Troubleshooting","description":"Common problems and fixes when running a Whitechain RPC node: missing configuration, artifact validation failures, slow sync, and transaction errors.","href":"/operate/run-a-node/troubleshooting"}]},{"group":"Migration","icon":"arrow-right-arrow-left","pages":[{"title":"How the migration works","href":"/operate/migration/how-migration-works"},{"title":"Verify the migration","href":"/operate/migration/verify-the-migration"}]}]},{"tab":"Legacy","pages":[{"title":"Legacy","href":"/legacy/overview"}]}]},"basePath":"","title":"Node maintenance - Whitechain","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}