pingcap / pingcap/docs

Unable to run playground on Debian Linux by following docs

Open
#21,605 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

contribution first-time-contributor
Dominant language
Python
Stars
617
Forks
724
Avg merge
2d 10h
Merged PRs (30d)
223

Description

I installed tiup by using docs on this page: https://docs.pingcap.com/tidb/stable/quick-start-with-tidb/

Image

tiup playground command constantly failed with the following error:

Checking updates for component playground... Timedout (after 2s)
The component `playground` version  is not installed; downloading from repository.
Warn: invalid signature for file root.json: not enough signatures (2) for threshold 3 in root.json
Error: no trusted root in the local manifests

Running tiup update --all fixed the issue. It was simple to fix, but still took a few minutes, which isn't good for quick-start.


System: Linux ***** 6.1.0-37-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.140-1 (2025-05-22) x86_64 GNU/Linux

Contributor guide

Open the contributing guide

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.

Research direction

Start with the TiDB stable quick-start page linked in the issue and review the steps around installing TiUP and running tiup playground. Verify the Debian failure and the reported tiup update --all workaround; the documentation is done when a fresh quick-start path includes the required step or otherwise avoids the signature error.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.