diff --git a/scripts/distribution/configs/databend-meta.toml b/scripts/distribution/configs/databend-meta.toml
index a6447e481911c..edecb1b072491 100644
--- a/scripts/distribution/configs/databend-meta.toml
+++ b/scripts/distribution/configs/databend-meta.toml
@@ -1,8 +1,9 @@
 # Usage:
 # databend-meta -c databend-meta.toml
 
-admin_api_address       = "0.0.0.0:28101"
+admin_api_address       = "0.0.0.0:28002"
 grpc_api_address        = "0.0.0.0:9191"
+# NOTE: change this to the ip address reachable from databend-query.
 # databend-query fetch this address to update its databend-meta endpoints list,
 # in case databend-meta cluster changes.
 grpc_api_advertise_host = "127.0.0.1"
@@ -17,12 +18,16 @@ dir = "/var/log/databend"
 [raft_config]
 id            = 1
 raft_dir      = "/var/lib/databend/raft"
-raft_api_port = 28103
+raft_api_port = 28004
 
 # Assign raft_{listen|advertise}_host in test config.
 # This allows you to catch a bug in unit tests when something goes wrong in raft meta nodes communication.
 raft_listen_host = "127.0.0.1"
+# NOTE: change this to the ip address or hostname reachable from other databend-meta nodes.
 raft_advertise_host = "localhost"
 
 # Start up mode: single node cluster
 single        = true
+
+# Start up mode: join a cluster
+# join          = ["127.0.0.1:28104"]
diff --git a/scripts/distribution/configs/databend-query.toml b/scripts/distribution/configs/databend-query.toml
index 35c15872536d3..3b05bed4f8856 100644
--- a/scripts/distribution/configs/databend-query.toml
+++ b/scripts/distribution/configs/databend-query.toml
@@ -6,7 +6,7 @@ max_active_sessions = 256
 shutdown_wait_timeout_ms = 5000
 
 # Internal flight rpc for cluster communication.
-flight_api_address = "0.0.0.0:9091"
+flight_api_address = "0.0.0.0:9090"
 
 # Admin REST API.
 admin_api_address = "0.0.0.0:8080"
@@ -42,13 +42,13 @@ table_engine_memory_enabled = true
 # [[query.users]]
 # name = "databend"
 # auth_type = "double_sha1_password"
-# # echo -n "databend" | sha1sum | cut -d' ' -f1 | xxd -r -p | sha1sum
+# # to generate auth_string: echo -n "databend" | sha1sum | cut -d' ' -f1 | xxd -r -p | sha1sum
 # auth_string = "3081f32caef285c232d066033c89a78d88a6d8a5"
 
 # [[query.users]]
 # name = "datafuselabs"
 # auth_type = "sha256_password"
-# #  echo -n "datafuselabs" | sha256sum
+# # to generate auth_string: echo -n "datafuselabs" | sha256sum
 # auth_string = "6db1a2f5da402b43c066fcadcbf78f04260b3236d9035e44dd463f21e29e6f3b"