Unregistering Repositories

Unregistering repositories guide in Porch

Unregistering Repositories

When you no longer need Porch to manage packages from a repository, you can unregister it. This removes Porch’s connection to the repository without affecting the underlying Git storage.

Unregister a Repository

Remove a repository from Porch:

porchctl repo unregister porch-test --namespace default

This command removes the Repository resource from Kubernetes, it stops synchronizing packages from the repository, removes Porch’s cached metadata for the repository but does not delete the underlying Git repository or its contents.

Example output:

porch-test unregistered

What happens to packages:

  • Published packages in Git: Remain in the Git repository and are preserved. If you re-register the same repository later, these packages will reappear when Porch synchronizes.
  • Draft/Proposed packages pushed to Git: Also remain in Git and will reappear upon re-registration.
  • Unpushed work-in-progress packages: Cached packages that were never pushed to Git (draft packages being edited) are removed and cannot be recovered.