You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/node-migration-guide.md
+4-28Lines changed: 4 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -139,41 +139,17 @@ For additional security, the backup and restore process encrypts keyshares durin
139
139
**Important:** The `MPC_BACKUP_ENCRYPTION_KEY_HEX` must be the same between the backup-cli and the node it is currently communicating with (e.g., the old node when running `get-keyshares`, and the new node when running `put-keyshares`).
140
140
141
141
142
-
### Obtain the encryption key (differs for TEE vs non-TEE nodes)
142
+
### Retrieve a key from an existing node.
143
143
144
-
How you obtain `MPC_BACKUP_ENCRYPTION_KEY_HEX` depends on whether the node runs
145
-
inside a TEE (TDX/dstack) or not.
146
-
147
-
If the key is not provided (neither the `MPC_BACKUP_ENCRYPTION_KEY_HEX` env var nor
148
-
the `[mpc_node_config.secrets] backup_encryption_key_hex` config field is set), the
149
-
node auto-generates one and writes it to `$MPC_HOME_DIR/backup_encryption_key.hex`.
150
-
Whether you can *read that file back* is the difference:
151
-
152
-
**Non-TEE nodes.**`$MPC_HOME_DIR` is on the host filesystem, so you can retrieve
153
-
the auto-generated key directly:
144
+
**Note:** If your node has been running without the `MPC_BACKUP_ENCRYPTION_KEY_HEX` environment variable set, the node automatically generates an encryption key and stores it in a file called `backup_encryption_key.hex` in your `$MPC_HOME_DIR` directory. You can retrieve it with:
Copy this key and set it as the `BACKUP_ENCRYPTION_KEY` environment variable for the backup-cli when running `get-keyshares`.
174
151
175
-
In both cases, set the resulting key as the `BACKUP_ENCRYPTION_KEY` environment
176
-
variable for the backup-cli when running `get-keyshares`.
152
+
> **TEE (TDX/dstack) nodes:**`$MPC_HOME_DIR` (`/data`) is inside the CVM's encrypted disk, so you cannot read the auto-generated `backup_encryption_key.hex`. Set `backup_encryption_key_hex` in the `[mpc_node_config.secrets]` block of the node's user-config **before first start** and keep a copy outside the CVM — that is the key you pass to the backup-cli.
0 commit comments