COREDNS-GRPC_SERVER(7)

💅 COREDNS-GRPC_SERVER(7) 💅

ok so this is a page from the CoreDNS Plugins manual, and bestie, it's literally all about tuning your DNS-over-gRPC server. let's get into it 🫶

---

✨ NAME ✨

grpc_server — the plugin that configures all your DNS-over-gRPC server options. she's the one who sets the boundaries, periodt. 🎀

---

🌸 DESCRIPTION 🌸

the grpc_server plugin lets you configure parameters for the DNS-over-gRPC server so you can fine-tune the security posture and performance of the server. like, you get to decide how much chaos the server will tolerate, and honestly? iconic. 👑

okay important thing, no cap: this plugin can only be used once per gRPC listener block. one and done, bestie. don't try to stack 'em. 💀

---

🦋 SYNTAX 🦋

grpc_server {
    max_streams POSITIVE_INTEGER
    max_connections POSITIVE_INTEGER
}

• max_streams POSITIVE_INTEGER — this one limits the number of concurrent gRPC streams per connection. it's giving "let's not have unbounded streams on a single connection exhausting server resources", which is lowkey so real of it. the default value is 256 if you don't specify anything. and if you set it to 0, that's unbounded — the wild west, no rules, yolo. 🙈
• max_connections POSITIVE_INTEGER — limits the number of concurrent TCP connections to the gRPC server. the default value is 200 if not specified. set it to 0 for unbounded, if that's the vibe you're going for. ✨

---

💖 EXAMPLES 💖

🎀 set custom limits for maximum streams and connections

like, pick your own numbers, main character energy:

grpc://.:8053 {
    tls cert.pem key.pem
    grpc_server {
        max_streams 50
        max_connections 100
    }
    whoami
}

🌈 set values to 0 for unbounded

this one matches CoreDNS behaviour from before v1.14.0 — aka the nostalgic era, the before times. 🕰️

grpc://.:8053 {
    tls cert.pem key.pem
    grpc_server {
        max_streams 0
        max_connections 0
    }
    whoami
}

---

reminder bestie: 0 means unbounded on both of these. so like, actually know what you're doing before you go setting things to 0 💅

---

that's the whole page, fr fr — brought to you by CoreDNS, dated March 2026, and this plugin manual page is COREDNS-GRPC_SERVER(7) in the CoreDNS Plugins manual. slay, go tune those limits 💜⭐