How to run a Fresh Start for a training or empty tenant?

TB Books · data-migration · Last updated September 15, 2026 · Version 1

This process works in apps: TB Books, TB One, TB Sync, TB WMS, TB POS, TB CRM

This article will teach you how to turn on the Fresh Start permission in TB One, then wipe a tenant from Data Migration so you can train or start over.

Fresh Start is the Danger Zone wipe for a training tenant or a true clean slate. It lives on Organization Settings → Data Migration in any product app, but the permission that unlocks the button is not on Books Permissions. You enable Run Fresh Start (Danger Zone) in TB One (one.tirebase.io) → Settings → Permissions. The flag is off by default for Admin and Superadmin so a shop cannot wipe itself by accident. Users and logins stay; catalog, customers, vendors, financials, locations, and related operational data are deleted and the chart of accounts is reseeded at $0. This is not reversible.

Steps

• Open TB One (one.tirebase.io) — use the app launcher if you are in Books. Do not look for this toggle under Books → Settings → Permissions; that page only shows Books-specific flags.
• Go to Settings → Permissions (Organization Settings). Confirm the header tenant is the organization you intend to wipe.
• Select the role you actually sign in as (Admin, or Superadmin if that is your role). Turn on Run Fresh Start (Danger Zone). Click Save.
• Return to Books (or TB One) → Settings → Data Migration and reload the page so the new permission applies.
• In Danger Zone, click Fresh Start. Read every consequence: catalog, stock, customers, vendors, invoices, bills, journals, work orders, banking, locations, and CRM/Sync operational data are removed. Users and auth are kept.
• Type the full tenant ID shown on the confirm dialog (copy/paste is disabled), then type NUKE, and submit Wipe Everything.
• Watch Activity for the Fresh Start job until it shows Done. Download the backup from that row if you need a copy before it expires (30 days).

Conclusion & best practices

Use Fresh Start only on training tenants or an empty shop you are willing to rebuild. Production live data cannot be restored from this wipe except the short-lived job backup. Delete Catalog and Delete Customers are smaller Danger Zone tools and do not require this permission. After a Fresh Start, re-import catalog and customers from Data Migration and confirm locations and tax rates before taking orders.