Clean and reinstall process - KSP-CKAN/CKAN GitHub Wiki

If you have installed all your mods through CKAN, it is a quick and painless process to completely re-create your modded KSP installation. This will clean up most CKAN errors you may be experiencing.

If your registry got corrupted or there's another reason you can no longer start CKAN, skip this phase.

1. Open the CKAN GUI client
2. Click File → Export modpack...
3. Click Export
4. Browse to a location in the save dialog
5. Type a filename for your mod list
6. Click the Save button
7. Close the CKAN client

1. Open your operating system's file manager/explorer program
2. Go to your KSP game folder (directory)
3. Copy the "CKAN" folder to "CKAN-backup"
4. Copy your "GameData" folder to "GameData-backup"
5. Copy your "Ships" folder to "Ships-backup"
6. Open the CKAN GUI client (again, only if you are still able to)
7. Uninstall all mods
8. Close the CKAN client
9. Open the "CKAN" folder
10. Select all files other than the "history" and "downloads" folder and the "installed-<instance-name>.ckan".
11. Delete the selected files
12. Return to KSP game folder
13. Open your "GameData" folder
14. Select all contents, then find the "Squad" and "SquadExpansion" (if present) folders/directories and un-select them
15. Delete the selected files & folders

At the end of this process you should have a "CKAN" folder containing a "downloads" folder which contains all your cached downloads, and a "GameData" folder containing just the original "Squad" folder with all its contents as installed with the game.

If you have Steam:

1. Return to KSP game folder
2. Delete your "Ships" folder
3. Open Steam
4. Right click on KSP
5. Properties...
6. Local Files tab
7. Verify integrity of game files...

This will restore the stock crafts only to your Ships folder.

If you don't have Steam:

1. Return to KSP game folder
2. Open your Ships folder
3. In the SPH, VAB, @thumbs/SPH, and @thumbs/VAB folders, delete all files for non-stock craft.

1. Open the CKAN client
2. Select the compatible KSP versions as before
3. Click on "Refresh" to get an up to date list of mod releases
4. Click on the File menu, then select Install from .ckan...
5. If you exported your mods in Phase 1, select that .ckan file. If not, select the "installed-<instance-name>.ckan" file or any older backup file in the "history" folder
6. Click on Open
7. Click on Continue

If any of your mods were old versions, they will be downloaded and the new versions will be installed, while all other mods should be installed from cache.

If all your mods are installed successfully and you are no longer experiencing errors, perform the following steps:

1. Return to your operating system's file manager/explorer program
2. Delete the "CKAN-backup", "Ships-backup", and "GameData-backup" folders

If instead, things are now worse than they were before, perform the following steps before continuing your troubleshooting:

1. Return to your operating system's file manager/explorer program
2. Delete the "CKAN" and "GameData" Folders
3. Rename the "CKAN-backup" folder to "CKAN"
4. Rename the "GameData-backup" folder to "GameData"
5. Rename the "Ships-backup" folder to "Ships"