Private Module Registry module in permanent pending state

Troubleshooting

Problem

A module published to the HCP Terraform private module registry may become permanently stuck in a pending state. In the UI, the module shows a "pending" status.

HCP Terraform UI showing a module in a pending state.

When you select the module, the details screen also indicates the pending ingress status.

HCP Terraform UI showing the details of a pending module.

Cause

This issue typically occurs when a module does not meet all module publishing requirements.

Solution

To resolve this issue, you must delete the pending module from the registry. You can then correct any issues with the module's repository and attempt to publish it again.

Navigate to the private module registry in the HCP Terraform UI.
Click the pending button next to the module you want to delete.

This action navigates you to a status page with a URL similar to this example:

https://app.terraform.io/app/<ORGANIZATION_NAME>/registry/modules/private/<NAMESPACE>/<MODULE_NAME>/<PROVIDER>/status

Select the Delete module button to permanently remove the module from the private module registry.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSGH5YK","label":"IBM Terraform Self-Managed"},"ARM Category":[{"code":"","label":""}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]

Historical Number

27098002826003

Was this topic helpful?

Document Information

Modified date:
30 March 2026

UID

ibm17265804

Tips