Australian cloud for business software — built and run in Sydney since 2002

NetLeverage
NetLeverage

Documenting a hosted estate so another provider can take over

Technical article
Hosting

About this article: This article is reviewed against the cited sources. This is source research, not lab validation. Check the stated versions and your own requirements before making changes.

Direct answer: Provider transition fails when knowledge lives in two engineers' inboxes. A living documentation pack for your hosted systems—updated after material changes—lists workloads, dependencies, credential locations (not secret values in the doc), licences, integrations, maintenance patterns and known quirks so another team can assume responsibility. It extends the inbound exit pack idea (what to demand from a departing host) into ongoing custody while you are still happily served.

Why it matters

Risk and operations leads need continuity if the hoster relationship changes, if you rebid managed services, or if a merger forces rapid separation. Reviews, insurers and regulators may ask for evidence that systems are documented—exact questions depend on your sector; this article does not state a universal audit checklist.

Documentation also lowers day-to-day friction: new staff onboard faster, integration disputes have a reference, and support tickets carry consistent service names.

Related published angles: One recovery inventory for a mixed estate (asset view) and Exit and data return when a hosted ISV customer leaves (ISV outbound exit). This article is buyer-side living documentation for any managed host.

How it works

Treat documentation as configuration items with owners and review dates—not a one-off Word export.

Minimum documentation sections (editorial template):

Section Contents Owner
Workload catalogue VM/app names, business function, users, RTO/RPO targets (customer-stated) IT lead
Network map VPNs, DNS zones, public names, firewall intent Network admin
Identity IdP, MFA, service accounts list (names only) Identity admin
Data Databases, file shares, backup/export schedules, customer-held copies Data owner
Integrations Webhooks, SFTP feeds, SMTP relays, partner IPs Integration owner
Licences OS, LOB, CAL/SPLA pointers—cross-check licence exit planning Commercial
Runbooks Patch window, restart order, vendor escalation Operations
Contacts Vendor support IDs, account managers, after-hours Service manager

Editorial: service management practice generally expects controlled service information; this table is a lightweight configuration management database (CMDB) substitute for SMB buyers, not a certified SMS or ISO/IEC 20000 implementation. The ISO catalogue entry for ISO/IEC 20000 confirms the standard exists; this article does not quote its requirements.

Living updates: trigger refresh after major upgrades, new integrations, DNS cuts, licence true-ups. Quarterly tick-box review if changes are quiet.

Credential hygiene: document where secrets live (vault path, break-glass safe), never paste production passwords into the pack. Incoming providers should receive secrets through an agreed secure channel during transition.

Dependency direction: capture outbound as well as inbound (callbacks, feeds) so steady-state webhook and post-move integration checklists stay aligned.

What to choose and why

Start one shared folder or wiki with the template above; partial truth beats aspirational completeness. Editorial judgement (not evidence): integrations and identity sections often pay off first at handover—prioritise them in early drafts.

Pair documentation with named customer portal roles (admin, finance, helpdesk) so updates have accountable owners.

When rebidding, offer the documentation under NDA rather than granting unlimited discovery calls.

Risks and limits

Diagrams in this article are conceptual, not infrastructure scans.

Document customer-visible configuration your organisation is entitled to hold—not undocumented copies of proprietary hoster internals.

Runbooks may include environment-specific commands; any destructive procedure requires lab validation before reuse (untested in this research).

Sources

Learning notes

  1. Living docs beat a frantic pre-exit ZIP attachment.
  2. Integrations and identity sections often matter most at handover (editorial judgement).
  3. Store credentials by reference, not in plain text.
  4. Customer-held copies of the documentation reduce single-provider lock-in.
  5. Quarterly review keeps documentation trusted.