How to Reproduce a Host

This procedure rebuilds a node from scratch so that it rejoins the topology without data loss and without manual guesswork.

Principle

Every host must be reproducible from: 1. This documentation 2. Secrets stored in the backup (config backup, password manager) 3. Data available on surviving nodes (relay or secondary)

General steps

1. Provision the OS

2. Restore Syncthing config

If the node was a source:

Get cert.pem, key.pem, config.xml from the secondary mirror: ~/mirror/st-config-backup/
Stop Syncthing (if running)
Place files in ~/.local/share/syncthing/
Start Syncthing — device ID and folder definitions are restored
Syncthing will resync all folders from relay and/or secondary

If the node was a relay (Docker):

If the node was a secondary:

3. Verify

All folders show as synced in Syncthing GUI
Run the test checklist for the relevant scenario

Host-specific notes

← Contact · How to Test a Scenario →

tf5-7hp · v2026-05-16 · Export created: 2026-06-11 15:09 UTC