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.

Phase 1 - Save your installed mods

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

Phase 2 - Clear out your KSP installation

  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.

Remove modded ships

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.
Stock craft files as of this writing (these are the ones you should NOT delete!):
  • @thumbs/VAB/GDLV3.png
  • @thumbs/VAB/Jumping Flea.png
  • @thumbs/VAB/AeroEquus.png
  • @thumbs/VAB/ComSat Lx.png
  • @thumbs/VAB/Titan II GLV.png
  • @thumbs/VAB/Dynawing.png
  • @thumbs/VAB/Ion-Powered Space Probe.png
  • @thumbs/VAB/Kerbal X.png
  • @thumbs/VAB/Agena 1.png
  • @thumbs/VAB/Z-MAP Satellite Launch Kit.png
  • @thumbs/VAB/Orbiter 1A.png
  • @thumbs/VAB/Kerbal 1-5.png
  • @thumbs/VAB/Slim Shuttle.png
  • @thumbs/VAB/Rover + Skycrane.png
  • @thumbs/VAB/Space Station Core.png
  • @thumbs/VAB/Super-Heavy Lander.png
  • @thumbs/VAB/Orbiter One.png
  • @thumbs/VAB/Science Jr.png
  • @thumbs/VAB/Prospector Rover.png
  • @thumbs/VAB/Kerbal 2.png
  • @thumbs/VAB/Learstar A1.png
  • @thumbs/VAB/Viewmatic Survey Satellite.png
  • @thumbs/VAB/PT Series Munsplorer.png
  • @thumbs/VAB/Kerbal 1.png
  • @thumbs/VAB/Two-Stage Lander.png
  • @thumbs/SPH/Dove.png
  • @thumbs/SPH/Stearwing A300.png
  • @thumbs/SPH/Stratolauncher.png
  • @thumbs/SPH/Crater Crawler.png
  • @thumbs/SPH/Satellite Launcher.png
  • @thumbs/SPH/Rocket-power VTOL.png
  • @thumbs/SPH/Gull.png
  • @thumbs/SPH/Aeris 4A.png
  • @thumbs/SPH/Ravenspear Mk3.png
  • @thumbs/SPH/Thunderbird.png
  • @thumbs/SPH/Osprey.png
  • @thumbs/SPH/Velociteze.png
  • @thumbs/SPH/Skywinder AE1.png
  • @thumbs/SPH/Mallard.png
  • @thumbs/SPH/Albatross 3.png
  • @thumbs/SPH/Aeris 3A.png
  • @thumbs/SPH/Prospector Rover.png
  • @thumbs/SPH/Ravenspear Mk4.png
  • @thumbs/SPH/Bug-E Buggy.png
  • @thumbs/SPH/Ravenspear Mk1.png
  • VAB/Z-MAP Satellite Launch Kit.craft
  • VAB/Super-Heavy Lander.craft
  • VAB/Learstar A1.loadmeta
  • VAB/Kerbal 1-5.craft
  • VAB/Kerbal 2.loadmeta
  • VAB/Rover + Skycrane.loadmeta
  • VAB/Super-Heavy Lander.loadmeta
  • VAB/Learstar A1.craft
  • VAB/GDLV3.craft
  • VAB/Orbiter One.craft
  • VAB/Viewmatic Survey Satellite.craft
  • VAB/Science Jr.loadmeta
  • VAB/Dynawing.loadmeta
  • VAB/Jumping Flea.craft
  • VAB/Rover + Skycrane.craft
  • VAB/Ion-Powered Space Probe.craft
  • VAB/Space Station Core.loadmeta
  • VAB/AeroEquus.craft
  • VAB/Slim Shuttle.craft
  • VAB/Dynawing.craft
  • VAB/Two-Stage Lander.craft
  • VAB/AeroEquus.loadmeta
  • VAB/Kerbal X.loadmeta
  • VAB/Kerbal X.craft
  • VAB/Space Station Core.craft
  • VAB/ComSat Lx.loadmeta
  • VAB/Jumping Flea.loadmeta
  • VAB/Two-Stage Lander.loadmeta
  • VAB/Orbiter 1A.loadmeta
  • VAB/Ion-Powered Space Probe.loadmeta
  • VAB/PT Series Munsplorer.loadmeta
  • VAB/Kerbal 2.craft
  • VAB/Science Jr.craft
  • VAB/Slim Shuttle.loadmeta
  • VAB/Kerbal 1-5.loadmeta
  • VAB/Viewmatic Survey Satellite.loadmeta
  • VAB/Kerbal 1.craft
  • VAB/ComSat Lx.craft
  • VAB/PT Series Munsplorer.craft
  • VAB/GDLV3.loadmeta
  • VAB/Orbiter One.loadmeta
  • VAB/Orbiter 1A.craft
  • VAB/Kerbal 1.loadmeta
  • VAB/Z-MAP Satellite Launch Kit.loadmeta
  • SPH/Osprey.loadmeta
  • SPH/Gull.craft
  • SPH/Stratolauncher.craft
  • SPH/Ravenspear Mk4.craft
  • SPH/Ravenspear Mk4.loadmeta
  • SPH/Stearwing A300.loadmeta
  • SPH/Crater Crawler.loadmeta
  • SPH/Aeris 3A.craft
  • SPH/Albatross 3.craft
  • SPH/Gull.loadmeta
  • SPH/Ravenspear Mk1.loadmeta
  • SPH/Prospector Rover.loadmeta
  • SPH/Stearwing A300.craft
  • SPH/Mallard.craft
  • SPH/Skywinder AE1.craft
  • SPH/Aeris 4A.loadmeta
  • SPH/Ravenspear Mk1.craft
  • SPH/Satellite Launcher.craft
  • SPH/Thunderbird.craft
  • SPH/Rocket-power VTOL.loadmeta
  • SPH/Stratolauncher.loadmeta
  • SPH/Crater Crawler.craft
  • SPH/Bug-E Buggy.craft
  • SPH/Aeris 3A.loadmeta
  • SPH/Thunderbird.loadmeta
  • SPH/Rocket-power VTOL.craft
  • SPH/Satellite Launcher.loadmeta
  • SPH/Mallard.loadmeta
  • SPH/Dove.loadmeta
  • SPH/Bug-E Buggy.loadmeta
  • SPH/Ravenspear Mk3.loadmeta
  • SPH/Prospector Rover.craft
  • SPH/Albatross 3.loadmeta
  • SPH/Ravenspear Mk3.craft
  • SPH/Aeris 4A.craft
  • SPH/Velociteze.loadmeta
  • SPH/Dove.craft
  • SPH/Osprey.craft
  • SPH/Skywinder AE1.loadmeta
  • SPH/Velociteze.craft

Phase 3 - Reinstall your mods

  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.

Phase 4 - Tidy up

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"
⚠️ **GitHub.com Fallback** ⚠️