Opensearch: Full reindex on new Cloud instance startup hangs at 0% and requires manual cancellation
@fabrizzio-dotCMS is already working on this.
Since Jul 9, 2026.
- Dominant language
- Java
- Stars
- 970
- Forks
- 486
- Avg merge
- 3d 33m
- Merged PRs (30d)
- 170
Description
Problem Statement
When a new dotCMS instance is provisioned in a Cloud environment seeded with the corpsite (starter) data, a full reindex is automatically triggered on startup. This reindex never progresses — it stays at 0% (0 / 8887) with an estimated time of n/a and remains stuck indefinitely.
Navigating to Maintenance → Index shows "A full reindex is in progress." with no forward progress. The only way to recover is to manually Stop Reindex Process, after which a new, manually-triggered reindex completes successfully.
This breaks the expected out-of-the-box experience for freshly provisioned cloud instances: the search index is not usable until an operator notices the stuck reindex and intervenes manually.
Impact: Every fresh instance provisioned with corpsite data on OpenSearch. Workaround exists (stop + re-run), so severity is Medium, but it requires manual intervention on every new instance.
Steps to Reproduce
Video screencast: reindex-on-instance-start.mov — to be attached (drag-and-drop into this issue).
Steps:
- Provision a new dotCMS instance in a Cloud environment (latest from
main). - Start it seeded with the corpsite starter data (OpenSearch backend).
- Once the instance is up, navigate to Maintenance → Index.
- Observe: "A full reindex is in progress." stuck at 0% — Reindex Progress: 0 / 8887, Time: n/a.
- Wait — the progress never advances.
- Click Stop Reindex Process.
- Trigger a new reindex manually.
- Observe the manual reindex now progresses and completes normally.
Expected vs. Actual:
| Behavior | |
|---|---|
| Expected | The automatic reindex on instance startup completes on its own; Index view shows advancing progress and a valid ETA. |
| Actual | Reindex hangs at 0 / 8887, Time: n/a, and requires a manual Stop Reindex Process before a working reindex can run. |
Images/Videos
https://github.com/user-attachments/assets/60adb3e4-d898-4065-8290-903516485719
Acceptance Criteria
- The automatic full reindex triggered on a fresh instance startup (Cloud environment, corpsite data, OpenSearch) completes successfully without manual intervention.
- The Maintenance → Index view shows real progress (document count advancing) and a valid time estimate instead of
n/awhile indexing. - No manual Stop Reindex Process + re-run is required to obtain a healthy index on a new instance.
- Root cause of the stuck
0 / 8887reindex on startup is identified and fixed (or documented as environmental with a mitigation if it is not a code defect).
dotCMS Version
Latest from main branch — reproduced on a Cloud environment.
Severity
Medium - Some functionality impacted (workaround: stop the stuck reindex and re-run manually).
Links
NA
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.