Feedback: Troubleshoot Self-Hosted Setup

Assessment

This issue has not been assessed yet.

Description

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

Getting set up

First steps

1. Read the whole issue, then the project's contributing guide.
2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
3. Fork the repository and make your change on a branch.
4. Open a pull request that references the issue number.

More from cockroachdb/docs

• Vector indexes page: say which Cloud plans support them, and that a non-prefix filter skips the index

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 88/100

  cockroachdb/docs#23467 · Opened Sep 26, 2026

• docs: clarify default operator class for vector indexing (CREATE VECTOR INDEX defaults to vector_l2_ops)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-3 hours Newbie friendliness 78/100

  cockroachdb/docs#23456 · Opened Aug 18, 2026

• Clarify that FROM is inclusive and TO is exclusive in range partitioning

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 1/5 Under an hour Newbie friendliness 88/100

  cockroachdb/docs#23454 · Opened Aug 4, 2026

• Charts and documentation use both `us-east-1` and `us-east1` (missing hyphen before the 1)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 2/5 1-2 days Newbie friendliness 68/100

  cockroachdb/docs#23445 · 1 comment · Opened Jun 22, 2026

• Branch existence check failure (automated)

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  sql-diagram-validation

  Difficulty 1/5 Under an hour Newbie friendliness 85/100

  cockroachdb/docs#23444 · 4 comments · Opened Jun 18, 2026

All issues in cockroachdb/docs