V0.1 · Architecture & service documentation

WHAT IT TAKES TO BRING A SERVICE BACK

A backup is a starting point.
A restore is the proof.

Proxmox Backup Server provides a VM-backup layer. The recovery model goes further: configuration, unique data, secure dependencies and application behaviour must come back together.

What the current design contains.

The documented estate uses Proxmox Backup Server with NAS-backed datastore storage. Selected applications have databases or files outside their application container. Elastic uses a supported snapshot repository, separately from its active index state.

The records include successful Elastic snapshot and synthetic dataset-restore evidence. That does not establish that every application, the full cluster or a site-wide disaster scenario has been restored successfully. Regular testing across all layers is an explicit requirement, with the programme still to be scheduled and executed comprehensively.

First, identify the complete recovery set.

  1. What can be recreated from Git, Ansible or Compose?
  2. Which data is unique, and where does it actually live?
  3. Which external or embedded databases belong to the service?
  4. Which files need to match the database recovery point?
  5. Which credentials, keys or certificates are required, by private reference?
  6. Which supporting services must be available first?

Unclassified data is not automatically disposable. Configured backups are not automatically validated backups. A NAS, replication or a VM snapshot is not automatically an independent recovery copy.

Then test a controlled recovery.

Recovery-test processSimplified flow
  1. STEP 01Select a recovery point
  2. STEP 02Restore in isolation
  3. STEP 03Rebuild dependencies
  4. STEP 04Validate the application

Choose a destination that avoids identity collisions and unintended connections to production. Disable external actions where appropriate. Restore the required state, apply configuration and prove the service can perform an operation relevant to its purpose.

Measure elapsed recovery time and the data gap, and compare them with the required recovery objectives. Record failures and next actions; a test that finds a problem is useful evidence, not a reason to mark the service recovered.

Application recovery sets and proposed acceptance checks · not a completed-test ledger
ServiceState to bring back togetherFunctional validation
PaperlessPostgreSQL metadata, document files and application configuration.Open a restored neutral document and verify its metadata and search.
n8nPostgreSQL, application files and required encryption/credential material.Run a safe isolated workflow without sending production actions.
FreshRSSPersistent SQLite-backed data and application configuration.Open the reader and verify expected subscriptions and a neutral entry.
Firefly IIIMySQL, relevant files and secure application dependencies.Read an isolated test record and validate the intended import path safely.
VaultwardenConfigured MySQL state, application files and secure recovery requirements.Authorised private client-operation test; never publish vault data.
Home automationApplication, broker and bridge state appropriate to each component.Harmless isolated integration test with real-world actions prevented.
ElasticSupported snapshots, deployment configuration and access requirements.Restore a controlled dataset and query known events.
Virtual machinesVM configuration, disks and state stored outside the guest.Boot, verify dependencies and perform a meaningful application operation.

Recover in dependency order.

Determine which supporting layers are needed before the application: compute and storage, the required network and naming, database availability, then application components and integrations. The exact order depends on the failure scenario; it is not always safe to assume every management tool is already available.

The backup platform itself also needs a recovery path. Access to retained backups and required secure material should not depend exclusively on the server that was lost.

Make testing recurring.

The intended programme covers files and volumes, databases, secure recovery dependencies, applications on a replacement environment, complete VMs and hosts, network support and backup-platform recovery. Cadence and coverage need an explicit calendar and recorded results.

Suggested frequencies in planning documents are proposals, not an installed scheduler. The public roadmap therefore identifies the recurring programme as work to complete rather than displaying invented success statistics.

Keep a useful test record.

ILLUSTRATIVE RECOVERY RECORD no secrets
service: example-notes
recovery-point: selected-backup-reference
destination: isolated-test-environment
validation:
  - open-application
  - read-known-test-record
  - verify-matching-file
record:
  - elapsed-recovery-time
  - recovered-data-point
  - observed-gaps
  - corrective-actions
  - next-test-date

Store sensitive recovery steps and secure references privately. Public material can explain the method without becoming a guide to administrative access.