Prepare for runtime installation

New installation
If this is your first time installing Codefresh, review and confirm that your deployment environment conforms to the minimum requirements for installation. Check the system requirements.

Existing installation
If you already have a runtime installation on your cluster, you have two options:

  1. To install on the same cluster, first uninstall the existing runtime. Currently, you can install a single runtime per cluster.
  2. Install on a different cluster, verifying that you meet the minimum requirements.

Uninstallation tips for existing runtimes

  • Before you run uninstall an existing runtime from the Codefresh UI, or run cf runtime <name> uninstall from the CLI, delete all Codefresh-related namespaces.
  • If a namespace is frozen in the Terminating status, it could be because the namespace has resources with finalizers that are preventing deletion. Here’s how you can remove finalizers using k9s:
    • In the applications view, do the following for each application:
      • Hit e to edit the YAML.
      • Scroll down to the section entitled finalizers.
      • Move cursor to the line with the finalizer definition, and then hit dd to delete the line.
      • Delete also the finalizers key.
      • To save and exit, hit escape wq: enter.
    • Try deleting the namespace again.

What to do next

Install runtime