Self-Host Guide

This section is for operators running SynckHub on their own infrastructure.

It is intentionally operations-first: topology, secrets, deploy workflow, recovery, and integrations.

What this section covers

  • Environment and topology choices (local, dev, selfhosted-prod)
  • Infra-ansible inventory, config, and release pinning
  • Maintenance-window deploy and rollback workflow
  • Common + SynckHub control-plane wiring
  • Office and Yjs coauthoring integration setup
  • Backups, monitoring, and secret rotation discipline

First deployment path

  1. start-here/deployment-models-and-scope.md
  2. start-here/prerequisites-checklist.md
  3. deployment/quickstart-new-vm.md
  4. deployment/config-and-inventory.md
  5. deployment/release-and-maintenance-workflow.md
  6. deployment/common-and-infra-registration.md

Ongoing operations path

  1. operations/backups-and-restore.md
  2. operations/monitoring-and-health.md
  3. operations/secrets-and-rotations.md
  4. operations/troubleshooting.md

Integrations path

  1. integrations/office-coauthoring.md
  2. integrations/yjs-coauthoring.md