More from MSP Reboot: depl0y · st0r
Migration Documentation

Migration Guides & Import Tooling

Replacing operational software is a real project. Data needs to move, workflows need to transfer, and staff need to be trained. ClientSt0r treats migration tooling as a core adoption requirement, not an afterthought.

What can be imported.

ClientSt0r supports import for the record types that matter most in an MSP migration. Coverage varies by import method — CSV wizard handles the most common types, the REST API covers everything.

Client & Contact Records

Organisation names, contacts, addresses, account types, and custom fields. The foundation — import these first, as all other records link to an org.

Asset Inventory

Hardware assets, serial numbers, warranty information, linked organisation, and asset type categories. Device type and location metadata is preserved where available.

Password Vault Entries

Credential records including username, URL, and notes. Records can be imported encrypted or re-encrypted on import using the destination vault key.

Knowledge Base Articles

Documentation content, article categories, and linked client organisation. Article body content is imported as-is — formatting may require review after import.

Ticket History

Historical tickets, status, assignee, time entries, and notes — imported as a read-only archive. Active ticket workflows cannot be migrated from other platforms.

Contract Records

Contract type, billing cycle, start and end dates, and linked organisation. Contract line items and associated invoices are supported where the source platform exports them.

Network Records

IP address assignments, subnet definitions, and VLAN configurations. Network topology data from other platforms maps to the IPAM module.

User Accounts

Staff user accounts and role assignments. Passwords are not migrated — all imported user accounts require a password reset on first login.

Two approaches to importing data.

Choose based on your data volume, technical comfort level, and the source platform. Both methods end up in the same place — the choice is about how you get there.

Built-in Wizard

CSV Import

The import wizard walks through column mapping and validation before committing records. Suitable for one-off migrations and smaller data sets where manual review is practical.

  1. Export CSV from your existing platform
  2. Upload to the ClientSt0r import wizard
  3. Map columns to ClientSt0r fields
  4. Preview and validate the mapped data
  5. Confirm import and review the results log
Supported record types
Clients & contacts Assets Vault entries KB articles Contracts
Field mapping: not every source platform uses the same column names. The wizard lets you map source columns to ClientSt0r fields before import. Unrecognised columns can be skipped or mapped to custom fields. Validation errors are shown per-row before committing. Duplicate detection checks against existing org names and asset serial numbers.
Scripted Migration

REST API Import

POST records programmatically using the ClientSt0r REST API. Suitable for large data sets, platforms with their own APIs, and migrations where you want full control over transformation logic before records land in the system.

The REST API accepts the same field structure as the CSV import wizard, with the same validation rules applied on write. Rate limiting applies — structure bulk imports with appropriate delay between batches.

Recommended for
Large datasets Complex field mapping IT Glue API Hudu API ConnectWise API Autotask API
API documentation and interactive explorer are available in-app after deployment. Full endpoint reference and example scripts are on GitHub. JWT authentication required — create a dedicated migration API key with appropriate scope rather than using an admin user token.

What to expect from common source platforms.

Each platform exports data differently. These notes cover what maps cleanly and where you should plan for manual work.

From IT Glue

IT Glue

IT Glue exports are available via their API or the data export feature in account settings. Organisations, contacts, documents, passwords, and configurations can be mapped to ClientSt0r equivalents. Password export requires IT Glue admin access. Network diagrams embedded in IT Glue documentation will need to be recreated manually in Draw.io — there is no automated conversion from IT Glue's diagram format.

From Hudu

Hudu

Hudu provides CSV export for most record types from the admin panel. Organisations, assets, passwords, and documentation map cleanly to ClientSt0r. Hudu Magic Dash data and custom integration displays are presentation-layer features and will need to be recreated. Custom asset layout fields can be mapped to ClientSt0r custom fields during the import process.

From ConnectWise Manage / Autotask

ConnectWise Manage & Autotask

PSA migration is primarily about ticket history and company/contact records. Active tickets should be wound down selectively before cutover — bulk migration of open tickets from a PSA into a new system mid-flight rarely goes well in practice. Bulk historical ticket import is supported as read-only archive data. Company and contact records export cleanly via both platforms' APIs and map directly to ClientSt0r organisations and contacts.

From HaloPSA

HaloPSA

Company records, contacts, and ticket history export is available via HaloPSA's reporting and API. Asset and configuration data can be exported via the HaloPSA API. Time entry records and contract data are exportable but may require transformation before import — the field structures differ from ClientSt0r's PSA module.

From Spreadsheets & Manual Systems

Spreadsheets / Manual Systems

CSV import covers most common cases for teams migrating from spreadsheet-based tracking. Prepare your data with consistent column headers before importing — the wizard expects each CSV to represent one record type. A single spreadsheet containing mixed record types should be split before upload. Simple cleanup in a spreadsheet editor before import saves time on the mapping step.

A practical order of operations.

Migrations that go wrong usually go wrong for the same reasons: data was not exported before subscriptions lapsed, records were imported in the wrong order breaking linkages, or staff were put on a new system before training was done. This checklist reflects the order that works.

  1. Export all data from existing platforms before cancelling subscriptions or allowing trial periods to lapse. Do this first — some platforms restrict export on downgrade or cancellation.
  2. Set up ClientSt0r on your infrastructure and verify it is functioning correctly before touching any data import. Test login, basic navigation, and API access.
  3. Import organisations and contacts first. Almost every other record type links to an organisation. Import these before anything else or linked records will fail validation.
  4. Import assets and network records. Assets link to organisations — this step must follow the org import. Verify a sample of records after import before proceeding.
  5. Import vault and password records. Verify that a sample of vault entries are accessible and decrypt correctly after import.
  6. Import documentation and knowledge base content. Review article formatting after import — some platforms export HTML that may need cleanup.
  7. Import ticket history if historical archive is required. This is optional — ticket history is read-only in ClientSt0r after import and does not affect active operations.
  8. Import contracts and billing records. These link to organisations and may reference contacts — both must be present before contract import.
  9. Configure integrations for RMM, distributors, and identity providers. Integration credentials must be entered fresh — they cannot be migrated from another platform.
  10. Set up user accounts and permissions. Imported user accounts require a password reset on first login. Verify role assignments match your intended access model.
  11. Run in parallel with existing tools for a defined transition period. Do not cut off access to the old system until you are confident data is intact and staff are operational.
  12. Train staff on the new system before designating ClientSt0r as the primary tool. A short internal session covering daily workflows reduces the friction of the cutover day.
  13. Cancel existing subscriptions only after full validation of imported data, working integrations, and confirmed staff readiness.

What does not migrate cleanly.

Be aware of these limitations before starting a migration. Planning around them early is considerably easier than discovering them mid-import.

Where to go when you hit problems.

Migration issues range from CSV formatting quirks to API authentication problems. Most have been seen before — check GitHub Issues before raising a new one.

Bug reports & questions

GitHub Issues

Migration-related bugs, import errors, and data mapping questions are tracked in GitHub Issues. Search before opening a new issue — there is a good chance the problem has come up before.

Open an issue →
Deployment prerequisites

INSTALL.md

The installation guide covers server requirements, database setup, and initial configuration. If ClientSt0r is not functioning correctly before migration starts, work through the install guide first.

Read the install guide →
Contributing

Migration tooling contributions

Platform-specific migration scripts and import helpers are welcome contributions. If you built a migration script for a platform not covered here, a pull request adding it to the repository benefits the whole community.

View the repository →