https://github.com/kentico/xperience-by-kentico-kentico-migration-tool
A customizable tool that migrates older Kentico solutions to the latest version of Xperience by Kentico.
https://github.com/kentico/xperience-by-kentico-kentico-migration-tool
dotnet kentico xperience-by-kentico xperience-by-kentico-integrations xperience-by-kentico-migrations
Last synced: 7 months ago
JSON representation
A customizable tool that migrates older Kentico solutions to the latest version of Xperience by Kentico.
- Host: GitHub
- URL: https://github.com/kentico/xperience-by-kentico-kentico-migration-tool
- Owner: Kentico
- License: mit
- Created: 2022-04-26T15:00:51.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-11T13:01:38.000Z (7 months ago)
- Last Synced: 2025-04-12T19:09:21.179Z (7 months ago)
- Topics: dotnet, kentico, xperience-by-kentico, xperience-by-kentico-integrations, xperience-by-kentico-migrations
- Language: C#
- Homepage:
- Size: 4.22 MB
- Stars: 9
- Watchers: 23
- Forks: 9
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: docs/Contributing-Setup.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
- Support: docs/Supported-Data.md
Awesome Lists containing this project
README
# Xperience by Kentico: Kentico Migration Tool
[](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support)
[](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/actions/workflows/build.yml)
## Description
This repository is part of the [Xperience by Kentico Migration Toolkit](https://github.com/Kentico/xperience-by-kentico-migration-toolkit).
The Kentico Migration Tool transfers content and other data from **Kentico Xperience 13**, **Kentico 12** or **Kentico 11** to **Xperience by Kentico**.
This tool supports migrating a project to Xperience by Kentico over multiple migration runs with built-in and custom data transformations.
Our documentation includes guides covering [the migration process from Kentico Xperience 13 to Xperience by Kentico](https://docs.kentico.com/x/migrate_from_kx13_guides).
## Library Version Matrix
View all [project releases](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/releases/).
| Xperience Version | Library Version |
| ----------------- | --------------- |
| 30.2.0 | 3.0.0 |
| 30.1.1 | 2.3.0 |
| 30.0.0 | 2.0.0 |
| 29.7.0 | 1.6.0 |
| 29.6.0 | 1.4.0 |
| 29.5.2 | 1.3.0 |
| 29.3.3 | 1.2.0 |
| 29.2.0 | 1.1.0 |
| 29.1.0 | 1.0.0 |
## Dependencies
- [ASP.NET Core 8.0](https://dotnet.microsoft.com/en-us/download)
- [Xperience by Kentico](https://docs.kentico.com/changelog)
## Quick Start
Follow the steps below to run the Kentico Migration Tool:
1. Clone or download source code from this repository.
2. Open the `.\Migration.Tool.sln` solution in your IDE.
3. Configure the options in the `.\Migration.Tool.CLI\appsettings.json` configuration file.
- See [`Migration.Tool.CLI/README.md - Configuration`](./Migration.Tool.CLI/README.md#Configuration) for details.
4. Build the solution.
5. Open the the repository folder [in a terminal](https://github.com/microsoft/terminal).
6. Navigate to the output directory of the `Migration.Tool.CLI` project.
- `.\Migration.Tool.CLI\bin\Debug\net8.0`
7. Run the `Migration.Tool.CLI.exe migrate` command.
- The following example shows the command with all parameters for complete migration:
```powershell
.\Migration.Tool.CLI.exe migrate --sites --custom-modules --users --settings-keys --page-types --pages --attachments --contact-management --forms --media-libraries --data-protection --countries --custom-tables --members --categories
```
8. Review the command line output of the tool.
- The output is also logged to a file `logs\log-.txt` under the output directory by default.
9. Review the migration protocol output, which provides information about the result of the migration, lists required manual steps, etc.
- The output file path is found in the `Migration.Tool.CLI/appsettings.json` configuration file under the `MigrationProtocolPath` setting.
The data is now migrated to the target Xperience by Kentico instance according to your configuration.
## Full Requirements
This repository contains several README documents containing information necessary for the correct usage of the Kentico Migration Tool.
- [Migration CLI](./Migration.Tool.CLI/README.md) - detailed information about the migration CLI, configuration options, instructions related to individual object types, and manual migration steps.
- [Usage Guide](./docs/Usage-Guide.md) - information about what kind of projects the Kentico Migration Tool supports.
- [Supported Data](./docs/Supported-Data.md) - lists all available data for migration
- [Migration Protocol](./Migration.Tool.CLI/MIGRATION_PROTOCOL_REFERENCE.md) - provides information about the results of the migration and required manual steps, etc.
## Contributing
If you are [creating an issue](https://github.com/Kentico/xperience-by-kentico-kentico-migration-tool/issues/new) please provide all available information about the problem or error. If possible, include the command line output log file and migration protocol generated for your `Migration.Tool.CLI.exe migrate` command.
To see the guidelines for Contributing to Kentico open source software, please see [Kentico's `CONTRIBUTING.md`](https://github.com/Kentico/.github/blob/main/CONTRIBUTING.md) for more information and follow the [Kentico's `CODE_OF_CONDUCT`](https://github.com/Kentico/.github/blob/main/CODE_OF_CONDUCT.md).
Instructions and technical details for **contributing to this project** can be found in [Contributing Setup](./docs/Contributing-Setup.md).
## License
Distributed under the MIT License. See [`LICENSE.md`](./LICENSE.md) for more information.
## Support
[](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support)
This project has **Full support by 7-day bug-fix policy**.
See [`SUPPORT.md`](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support) for more information.
## Security
For any security issues see [Kentico's `SECURITY.md`](https://github.com/Kentico/.github/blob/main/SECURITY.md).