kmesh-net/kmesh

Improve setup documentation with prerequisites and clearer installation flow

Open

#1,642 opened on Apr 4, 2026

View on GitHub
 (3 comments) (0 reactions) (1 assignee)Go (239 forks)auto 404
good first issue

Repository metrics

Stars
 (739 stars)
PR merge metrics
 (PR metrics pending)

Description

Problem

While setting up Kmesh locally, I noticed that the current documentation can be confusing for new contributors, especially around the installation flow.

Some key challenges:

  • Istio dependency is not clearly highlighted before deployment
  • The correct setup order is not explicitly defined
  • It is unclear how to verify a successful installation
  • New users may attempt to run kmesh-daemon directly without a Kubernetes environment

Proposed Solution

I would like to improve the setup documentation by:

  • Adding a "Prerequisites" section (including Istio requirement)
  • Defining a clear setup flow (Kubernetes → Istio → Kmesh)
  • Adding verification steps (e.g., checking running pods)
  • Including a "Common Mistakes" section to avoid confusion

Motivation

As a new contributor, I faced these issues during setup. Improving the documentation would make onboarding easier for others and reduce setup friction.

Additional Context

I have successfully set up Kmesh locally and verified the deployment, so I can contribute these improvements based on real experience.


I would like to work on this issue. Please let me know if this approach looks good.

Contributor guide