Backup and Restore Runbook

This page focuses on practical backup and restore steps.

What to back up

Minimum:

config/ServerProperties.json
service wrapper files
deployment notes for ports and tokens

Recommended:

previous release artifacts
logs around the last good known state
plugin configs such as GeyserVoice/config.yml

Before changing anything

Take a snapshot when you are about to:

upgrade VoiceCraft
change transports
rotate tokens
switch topology

Restore workflow

Stop the affected service.
Restore ServerProperties.json.
Restore related plugin or addon config if the topology changed.
Restart VoiceCraft.
Validate transport auth and bind flow.

What a restore does not fix automatically

firewall mistakes
DNS or host reachability issues
mismatched client or plugin config
topology mistakes after a network redesign

Validation after restore

Check:

server starts cleanly
chosen transport is enabled
token matches the integrating node
player bind and audio flow work again