S

Migration guide

How to migrate from Synology DSM to CasaOS

Technical infrastructure migrations vary a lot depending on the tool — these are the general steps that apply to most cases.

1. 1

   Export your configuration and data from Synology DSM

   Check Synology DSM's documentation for exporting projects, configuration and integrations — the exact format depends on the service, but almost all offer some export path for paid accounts.

2. 2

   Prepare the CasaOS environment

   Deploy CasaOS in a staging environment first (not production) and replicate the base configuration before moving any real data.

3. 3

   Migrate in pieces and validate each one

   Move one project or integration at a time instead of all at once, checking that each piece works in CasaOS before moving on to the next.

4. 4

   Update integrations that depended on Synology DSM

   Any external service (CI/CD, webhooks, SDKs) that pointed at Synology DSM needs to be reconfigured to point at your new CasaOS instance.

These steps are a general guideline — the exact export menu can vary depending on Synology DSM's plan and version.