{"Entry":{"collection":"guc","key":"bonjour_name","name":"bonjour_name","aliases":[],"metadata":{"baseline":false,"boot_human":"Not specified","boot_val":null,"category":"Connections and Authentication / Connection Settings","category_zh":"","changed_in":["18"],"changes":[{"documentation_changed":false,"fields":{},"from":"8.0","status":"added","to":"8.1"},{"documentation_changed":true,"fields":{},"from":"8.1","status":"changed","to":"8.2"},{"documentation_changed":true,"fields":{},"from":"8.4","status":"changed","to":"9.0"},{"documentation_changed":false,"fields":{"extra_desc":{"from":null,"to":"An empty string means use the computer name."}},"from":"17","status":"changed","to":"18"}],"content_hash":"4c6cfbb19dcb51e84dd6e861b6191536fecfe894826e97a5085ce192d8ecc546","context":"","default_changed_in":[],"default_history":[{"from":"9.0","to":"19","value":"Empty string"}],"editorial":{"advice":{"olap":"Analytical workload shape does not justify different bonjour_name behavior; use the same reviewed discovery policy and stable service identity.","oltp":"Enable bonjour_name 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_name off or empty unless local zero-configuration discovery is an explicit requirement; it does not improve database capacity."},"mechanism":["bonjour_name sets the Bonjour service name. An empty string means use the computer name. An empty value derives the advertised service name from the computer name, and the setting matters only when Bonjour advertisement is enabled.","bonjour_name 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_name, 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_name globally without a rollback plan and a client or operational compatibility test."],"references":[{"title":"PostgreSQL 19 Beta 4: bonjour_name","url":"https://www.postgresql.org/docs/19/runtime-config-connection.html#GUC-BONJOUR-NAME"},{"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_name is the PostgreSQL setting that defines the Bonjour service name."},"enumvals":[],"first_version":"8.1","group":"Connections and Authentication","group_slug":"connection","imported_at":"2026-09-27T17:57:30.908937+08:00","intro_commit":{},"key":"bonjour_name","last_version":"20","max_val":"","min_val":"","name":"bonjour_name","position":52,"present_in":["8.1","8.2","8.3","8.4","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":"Specifies the Bonjour service name.","short_desc_zh":"","source_rev":"english-manuals:2af433f87217866d1f3aa9384a1fa48178de6364fe8762db3a14ffb731d9b637","unit":"","vartype":"string"}},"Definition":{"Collection":"guc","Key":"bonjour_name","SourceDatabase":"center","Version":"18","SourceTable":"guc","SourceKey":"bonjour_name","SourceRevision":"english-manuals:2af433f87217866d1f3aa9384a1fa48178de6364fe8762db3a14ffb731d9b637","Facts":{"boot_val":"","category":"Connections and Authentication / Connection Settings","context":"postmaster","description":"Specifies the Bonjour service name. The computer name is used if this parameter is set to the empty string '' (which is the default). This parameter is ignored if the server was not compiled with Bonjour support. This parameter can only be set at server start.","doc":{"anchor":"GUC-BONJOUR-NAME","file":"runtime-config-connection.html","lang":"en","sha256":"567ba928f3e4c4783f548dc8a54f1e748f02bbe163924605f2132eb5b0da440d","slug":"18"},"documented":true,"enumvals":null,"extra_desc":"An empty string means use the computer name.","lang":"en","max_val":null,"metadata_version":"18","min_val":null,"name":"bonjour_name","short_desc":"Sets the Bonjour service name.","source":"pg-settings-source-snapshot","unit":null,"vartype":"string"},"ManualEvidence":{"doc":{"anchor":"GUC-BONJOUR-NAME","file":"runtime-config-connection.html","lang":"en","sha256":"567ba928f3e4c4783f548dc8a54f1e748f02bbe163924605f2132eb5b0da440d","slug":"18"}},"MeasuredEvidence":{"metadata_version":"18"}},"Text":{"Collection":"guc","Key":"bonjour_name","SourceDatabase":"center","Version":"18","Locale":"en","Title":"bonjour_name","Summary":"Specifies the Bonjour service name. The computer name is used if this parameter is set to the empty string '' (which is the default). This parameter is ignored if the server was not compiled with Bonjour support. This parameter can only be set at server start.","BodyHTML":"\u003cp\u003eSpecifies the Bonjour service name. The computer name is used if this parameter is set to the empty string \u0026#39;\u0026#39; (which is the default). This parameter is ignored if the server was not compiled with Bonjour support. This parameter can only be set at server start.\u003c/p\u003e","SourceRevision":"english-manuals:2af433f87217866d1f3aa9384a1fa48178de6364fe8762db3a14ffb731d9b637","ContentHash":"7d84438ac9eaac2ac78954b741a9e3262715a2c0b8dc866258130ed2d23fba5e","Payload":{"description":"Specifies the Bonjour service name. The computer name is used if this parameter is set to the empty string '' (which is the default). This parameter is ignored if the server was not compiled with Bonjour support. 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","8.1","8.2","8.3","8.4","9.0","9.1","9.2","9.3","9.4","9.5","9.6"],"Locales":["en"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}