From 3688450be42be9f67694a30605d64f9738f85e1d Mon Sep 17 00:00:00 2001
From: xchy2004 <2870221405@qq.com>
Date: Wed, 3 Jun 2026 17:13:31 +0800
Subject: [PATCH] docs: add namingserver registry documentation

---
 docs/user/registry/namingserver.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/docs/user/registry/namingserver.md b/docs/user/registry/namingserver.md
index 8f9293a8d53..9af36a8ae1f 100644
--- a/docs/user/registry/namingserver.md
+++ b/docs/user/registry/namingserver.md
@@ -1 +1,27 @@
-Placeholder. DO NOT DELETE.
+---
+title: Seata Namingserver Registry
+keywords: [Seata, Namingserver, Registry]
+description: Use Seata Namingserver as the registry center.
+---
+
+# Namingserver Registry
+
+Namingserver is Seata's native registry center. It maintains the mapping between transaction groups and Seata server clusters, and helps Seata clients discover available Seata server nodes.
+
+:::caution
+Namingserver is currently a beta feature. Please evaluate it carefully before using it in production, and do not expose the service directly to the public network.
+:::
+
+## Start Namingserver
+
+You can start Namingserver from a binary package or by using the Docker image.
+
+### Start from Binary Package
+
+Download and extract the Seata binary package, then enter the `seata-namingserver` directory.
+
+For macOS or Linux:
+
+```shell
+bin/seata-namingserver.sh
+