{"Entry":{"collection":"guc","key":"bonjour","name":"bonjour","aliases":[],"metadata":{"baseline":false,"boot_human":"Not specified","boot_val":null,"category":"Connections and Authentication / Connection Settings","category_zh":"","changed_in":[],"changes":[{"documentation_changed":false,"fields":{},"from":"8.4","status":"added","to":"9.0"}],"content_hash":"05cdcae10228fd2eb3abc5866a4626b8b050a11c686cf1f40d0e6925bac78bc5","context":"","default_changed_in":[],"default_history":[{"from":"9.0","to":"19","value":"off"}],"editorial":{"advice":{"olap":"Analytical workload shape does not justify different bonjour behavior; use the same reviewed discovery policy and stable service identity.","oltp":"Enable bonjour only when clients deliberately use Bonjour/mDNS on a trusted local network. Treat it as discovery metadata, never as authentication or a highly available service registry.","small":"Leave bonjour off or empty unless local zero-configuration discovery is an explicit requirement; it does not improve database capacity."},"mechanism":["bonjour enables advertising the server via Bonjour. It publishes a discoverable service through mDNS only on builds and platforms with Bonjour support; it does not open a listener or alter pg_hba.conf.","bonjour is a POSTMASTER-context setting: PostgreSQL reads it during server startup, and a configuration reload or session SET cannot activate a new value.","Bonjour advertisement depends on platform support and publishes the listener as metadata; listen_addresses, port, pg_hba.conf, TLS, and firewalls still define actual reachability and trust."],"pitfalls":["Expecting a reload or SET to activate bonjour, although it requires a controlled server restart.","Treating an mDNS advertisement as an access-control, authentication, or high-availability mechanism.","Publishing an unexpected service name or endpoint on an untrusted broadcast domain.","Changing bonjour globally without a rollback plan and a client or operational compatibility test."],"references":[{"title":"PostgreSQL 19 Beta 4: bonjour","url":"https://www.postgresql.org/docs/19/runtime-config-connection.html#GUC-BONJOUR"},{"title":"PostgreSQL 19 release notes","url":"https://www.postgresql.org/docs/19/release-19.html"}],"related":["listen_addresses","port","max_connections","reserved_connections","superuser_reserved_connections","unix_socket_directories"],"summary":"bonjour is the PostgreSQL setting that controls whether PostgreSQL enables advertising the server via Bonjour."},"enumvals":[],"first_version":"9.0","group":"Connections and Authentication","group_slug":"connection","imported_at":"2026-09-27T17:57:30.90604+08:00","intro_commit":{},"key":"bonjour","last_version":"20","max_val":"","min_val":"","name":"bonjour","position":51,"present_in":["9.0","9.1","9.2","9.3","9.4","9.5","9.6","10","11","12","13","14","15","16","17","18","19","20"],"short_desc":"Enables advertising the server's existence via Bonjour.","short_desc_zh":"","source_rev":"english-manuals:ee16e3cb97a40d9c4d9a096095492aa9683187a79607690c3b8941090274c297","unit":"","vartype":"bool"}},"Definition":{"Collection":"guc","Key":"bonjour","SourceDatabase":"center","Version":"18","SourceTable":"guc","SourceKey":"bonjour","SourceRevision":"english-manuals:ee16e3cb97a40d9c4d9a096095492aa9683187a79607690c3b8941090274c297","Facts":{"boot_val":"off","category":"Connections and Authentication / Connection Settings","context":"postmaster","description":"Enables advertising the server's existence via Bonjour. The default is off. This parameter can only be set at server start.","doc":{"anchor":"GUC-BONJOUR","file":"runtime-config-connection.html","lang":"en","sha256":"567ba928f3e4c4783f548dc8a54f1e748f02bbe163924605f2132eb5b0da440d","slug":"18"},"documented":true,"enumvals":null,"extra_desc":null,"lang":"en","max_val":null,"metadata_version":"18","min_val":null,"name":"bonjour","short_desc":"Enables advertising the server via Bonjour.","source":"pg-settings-source-snapshot","unit":null,"vartype":"bool"},"ManualEvidence":{"doc":{"anchor":"GUC-BONJOUR","file":"runtime-config-connection.html","lang":"en","sha256":"567ba928f3e4c4783f548dc8a54f1e748f02bbe163924605f2132eb5b0da440d","slug":"18"}},"MeasuredEvidence":{"metadata_version":"18"}},"Text":{"Collection":"guc","Key":"bonjour","SourceDatabase":"center","Version":"18","Locale":"en","Title":"bonjour","Summary":"Enables advertising the server's existence via Bonjour. The default is off. This parameter can only be set at server start.","BodyHTML":"\u003cp\u003eEnables advertising the server\u0026#39;s existence via Bonjour. The default is off. This parameter can only be set at server start.\u003c/p\u003e","SourceRevision":"english-manuals:ee16e3cb97a40d9c4d9a096095492aa9683187a79607690c3b8941090274c297","ContentHash":"f20d02224199ab65539c5abe3d5037211e86ff63fb33db422500573313db94e3","Payload":{"description":"Enables advertising the server's existence via Bonjour. The default is off. This parameter can only be set at server start."}},"RequestedLocale":"zh-Hans","Fallback":true,"Versions":["10","11","12","13","14","15","16","17","18","19","20","9.0","9.1","9.2","9.3","9.4","9.5","9.6"],"Locales":["en"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}