> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the migration plugin

> Use the migration plugin to migrate from an asset-centric to a data modeling-based Cognite Data Fusion (CDF) project.

Use the migration plugin to migrate from an asset-centric to a data modeling-based Cognite Data Fusion (CDF) project.

<Warning>
  The migration plugin is an experimental feature. Updates to the Cognite Toolkit are likely to introduce changes to the described commands and processes.
</Warning>

Enable the Migration plugin in your `cdf.toml` file:

```toml cdf.toml theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
# ...

[alpha_flags]
migrate = true

# ...
```

## Get started

<CardGroup cols={3}>
  <Card title="Kelmarsh example" icon="lightbulb" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/example">
    Learn about the Kelmarsh wind farm sample data and how the Cognite Data Fusion (CDF) migration plugin guides use it.
  </Card>

  <Card title="Known limitations" icon="book-open" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/known_limitations">
    Known limitations in data modeling that do not yet have feature parity with asset-centric CDF projects.
  </Card>

  <Card title="Migration overview" icon="list-checks" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/steps">
    Learn how to use the migration plugin to migrate from asset-centric to data modeling-based CDF projects.
  </Card>

  <Card title="Test with production data" icon="flask-conical" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/test_data">
    Replicate production data to a development CDF project so you can test migration before running it in production.
  </Card>
</CardGroup>

## Prepare

<CardGroup cols={2}>
  <Card title="Data model and mappings" icon="layers" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/data_model_migration">
    Create the data model and mappings prerequisite for migration.
  </Card>

  <Card title="Deploy CogniteMigration" icon="wrench" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/prepare">
    Deploy the CogniteMigration data model to prepare for migration from an asset-centric to a data modeling-based CDF project.
  </Card>
</CardGroup>

## Migrate resources

<CardGroup cols={3}>
  <Card title="Migrate data sets" icon="folder" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/datasets">
    Migrate data sets to instance spaces.
  </Card>

  <Card title="Migrate source systems" icon="network" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/source_systems">
    Use source systems to aid the migration from an asset-centric to a data modeling-based CDF project.
  </Card>

  <Card title="Migrate assets" icon="box" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/assets">
    Migrate assets from an asset-centric to a data modeling-based CDF project.
  </Card>

  <Card title="Migrate events" icon="calendar" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/events">
    Migrate events from an asset-centric to a data modeling-based Cognite Data Fusion (CDF) project.
  </Card>

  <Card title="Migrate events to records" icon="bolt" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/events_to_records">
    Migrate events to records in a data modeling-based Cognite Data Fusion (CDF) project.
  </Card>

  <Card title="Migrate files and time series" icon="file-text" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/files_timeseries">
    Migrate files and time series from an asset-centric to a data modeling-based CDF project.
  </Card>

  <Card title="Migrate annotations" icon="tag" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/annotations">
    Migrate annotations from an asset-centric to a data modeling-based CDF project.
  </Card>
</CardGroup>

## Migrate applications

<CardGroup cols={3}>
  <Card title="Migrate Canvas" icon="palette" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/canvas">
    Migrate asset-centric Canvas configurations to a data modeling-based Canvas.
  </Card>

  <Card title="Migrate Charts" icon="chart-bar" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/charts">
    Migrate asset-centric Charts configurations to a data modeling-based Charts.
  </Card>

  <Card title="Migrate InField" icon="clipboard-list" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/infield">
    Migrate InField application configuration and data to InField based on CDM.
  </Card>

  <Card title="Migrate 3D models" icon="box" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/3d">
    Migrate 3D models from an asset-centric to a data modeling-based CDF project.
  </Card>

  <Card title="Migrate 360 images" icon="camera" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/360_images">
    Migrate 360 images and 360 image annotations from an asset-centric to a data modeling-based CDF project.
  </Card>
</CardGroup>

## Reference

<CardGroup cols={2}>
  <Card title="Syncers" icon="database" href="/cdf/deploy/cdf_toolkit/guides/plugins/migration_plugin/syncers">
    Learn how CDF uses syncers to manage CogniteFile and CogniteTimeSeries data model concepts.
  </Card>
</CardGroup>

For up-to-date information on the available commands, use the `cdf migrate --help` command.