Prerequisites Checklist

This checklist is for SynckHub-managed Ansible deployments. Customer-operated Free Self-Hosting uses the separate deployment/free-self-hosting-compose.md prerequisites and must not install SynckHub SSH, Tailscale, Vault, or support credentials.

Host and network

  • Ubuntu 24.04 VM(s) provisioned
  • SSH access over Tailscale confirmed
  • Public DNS points to your edge hostnames
  • Ports and firewall policy align with your edge design

Secrets and config

  • Vault password flow in place
  • Required Vault values seeded (database, tokens, integration secrets)
  • Release pins file prepared in vars/releases/<release_id>.yml

Control-plane dependencies

  • Common base URL decided
  • Common bootstrap admin strategy chosen
  • SynckHub infra token strategy defined

Browser/API constraints

  • Common allowed origins include your web UI origin
  • SynckHub CORS allowed origins include your web UI origin

Operational guardrails

  • Backup target configured before first migration
  • Maintenance-window process agreed
  • Rollback owner and procedure documented
Previous
Prerequisites
Next
Release Workflow