> ## Documentation Index > Fetch the complete documentation index at: https://docs.msportal.ai/llms.txt > Use this file to discover all available pages before exploring further. # Onboarding & Setup Playbook > How to get a new MSPortal tenant from empty to first QBR. There are two pieces to onboarding. The **wizard** handles the one-time technical setup: integrations, roles, branding, billing. The **playbook** is the order to do everything else in so your first client engagement actually reaches a QBR. Run the wizard once. Run the playbook for each new client. ## Before you start Have these on hand: * PSA API credentials (ConnectWise, Autotask, HaloPSA, or SyncroMSP) * RMM API credentials (Datto RMM, NinjaOne, Asio, Syncro, Addigy, or Meraki) * Microsoft 365 global admin consent on your tenant, plus each client tenant you'll connect * Your logo and brand color * A domain you can add DNS records to, for sending email The wizard takes 30 to 60 minutes, plus PSA mapping (usually the longest part). The playbook plays out over 2 to 4 weeks against your first client. ## The wizard The wizard sits in the bottom-right of the screen the first time you sign in. It auto-completes most steps as you save settings, you can minimize or dismiss it, and progress is saved to your tenant. If you close it, click the rocket icon in the sidebar to bring it back. ### Setup steps **Foundation** 1. [Tenant Details](/user-guides/getting-started/onboarding/tenant-details). Address, timezone, basics. 2. [AI Settings](/user-guides/getting-started/onboarding/ai-settings). How the AI assistant talks about your business. 3. [Branding](/user-guides/getting-started/onboarding/branding). Logo, primary color. **Users and permissions** 4. [Tenant Roles](/user-guides/getting-started/onboarding/tenant-roles). Roles for your internal team. 5. [Company Permission Groups](/user-guides/getting-started/onboarding/company-permission-groups). Permission bundles for client users. 6. [Company Roles](/user-guides/getting-started/onboarding/company-roles). The roles your clients' users get assigned. **Integrations** 7. [Integration Selection](/user-guides/getting-started/onboarding/integration-selection). Pick your PSA and RMM. 8. [PSA Integration](/user-guides/getting-started/onboarding/psa-setup). Connect the PSA. 9. [Ticket Settings](/user-guides/getting-started/onboarding/ticket-settings). Sync direction and status mappings. 10. [RMM Integration](/user-guides/getting-started/onboarding/rmm-setup). Connect the RMM. 11. [Device Import](/user-guides/getting-started/onboarding/device-import). Pull devices in. **Other configuration** 12. [Email Domain](/user-guides/getting-started/onboarding/email-domain). Send email from your own domain. 13. [Training](/user-guides/getting-started/onboarding/training). Optional. Configure training courses. 14. [Billing](/user-guides/getting-started/onboarding/billing). Subscription and payment. **Per-client setup** 15. [Company M365 Setup](/user-guides/getting-started/onboarding/company-m365). Connect M365 for a client. 16. [Company Users](/user-guides/getting-started/onboarding/company-users). Import client users. If you only have time for the first pass, do **Tenant Details**, **Tenant Roles**, **Branding**, and your **PSA + RMM**. Everything else can come later. When the required steps are done, the wizard offers to mark onboarding complete. After that it stops appearing. You'll find the same settings in **Settings** in the sidebar. ## Setup Playbook The order to roll MSPortal out for a real client. Six stages, ending in a presented QBR. PSA, RMM, M365, and Backup & Security. The wizard covers this. Don't skip ticket status mappings or device import. Every later stage depends on the data these connectors pull in. See: [Integration Selection](/user-guides/getting-started/onboarding/integration-selection), [PSA](/user-guides/getting-started/onboarding/psa-setup), [RMM](/user-guides/getting-started/onboarding/rmm-setup), [Device Import](/user-guides/getting-started/onboarding/device-import), [Company M365 Setup](/user-guides/getting-started/onboarding/company-m365). Pre-load the [Planner](/user-guides/planner/index) with what you already know: your standard roadmap, the work the client has already agreed to, and obvious near-term items (firewall refresh, contract renewal, server EOL). Build [Compliance](/user-guides/compliance/index) checks against your MSP's standard so every client gets scored against the same baseline. If a client onboarding is coming up in the next two months, build it out now so the kickoff survey has something to link against. Tell the client what to expect. Use one of the standard kickoff [survey](/user-guides/surveys/index) templates or build your own. Run it, read the responses, and turn the ones that matter into client [Goals](/user-guides/goals/index). Link the planner items you seeded in stage 2 to the matching goals so every piece of work has a reason. Import products from your PSA. Build a [Budget](/user-guides/budgets/index) from the planner items' hours and cost estimates, then use the forecast view to project it forward. The forecast also drops in as a reporting widget for the QBR. Make a test [narrative report](/user-guides/reporting/index) with the client's real data, and add a budget widget. Create the upcoming QBR [meeting](/user-guides/calendar/meetings) and attach the budget and report. Turn on agenda automation so Claude drafts the agenda from live data. Approve it a week ahead so the client gets the pre-read on time. Run the QBR live in [presentation mode](/user-guides/calendar/presenting). Take notes as action items in the meeting. Those become planner items automatically. Send the summary when you're done. As you close out compliance checks during the quarter, the planner updates. Next quarter, start over at the kickoff survey. The [data flow](/user-guides/getting-started/data-flow) page explains what happens to a record once it's in MSPortal. This page tells you which records to create first. ## Next * [Data flow](/user-guides/getting-started/data-flow). How records move through MSPortal once integrations are live. * [Create a tenant role](/user-guides/getting-started/how-to-create-a-new-user-role). So you don't run setup as one person. * [Hide items from clients](/user-guides/getting-started/hiding-items-from-clients). Tighten what client-portal users see before you invite them.