Feedback: Troubleshoot Self-Hosted Setup

[rthurimella]

Page: https://cockroachlabs.com/docs/v25.4/cluster-setup-troubleshooting.html

What is the reason for your feedback?

[ X] Missing the information I need

[ ] Too complicated

[ ] Out of date

[ ] Something is broken

[ ] Other

Additional details

This part of the docs page does not appear to be correct:

"In order for the ballast file to be automatically created, the following conditions must be met:

Available disk space is at least four times the configured ballast file size.
Available disk space on the store after creating the ballast file is at least 10 GiB."

The natural interpretation is that BOTH conditions must be met. See the attached screenshot. Here the disk < 10GB, both before and after the creation of the ballast file. So, the second condition is not met.

This can be reproduced by walking through the steps in the following instruqt track:

https://play.instruqt.com/manage/cockroachlabs/tracks/ballast-files

Jira issue: DOC-15437

[sudarshankushwaha]

Hi! I’m a beginner contributor and would like to help fix this documentation issue.
Is this issue available for me to work on?