BGP Configuration Guide for Cisco 8000 Series Routers, Cisco IOS XR Releases

Disable a BGP neighbor

Updated: February 28, 2026

Want to summarize with AI?

Overview

Administratively shuts down a BGP neighbor session without removing its configuration for temporary maintenance or troubleshooting.

Administratively shut down a BGP neighbor session without removing its configuration.

Context: Use this procedure to temporarily disable a peer, for maintenance or troubleshooting.

Before you begin

None

Procedure

	1.	Run the configure command to enter global configuration mode. Example: `Router#configure`
	2.	Enter BGP configuration mode with your AS number and specify the neighbor. Example: `Router(config)# router bgp 100 Router(config-bgp)# neighbor 172.16.40.24`
	3.	Run the shutdown command to shut down the neighbor and save the configuration. Example: `Router(config-bgp-nbr)# shutdown Router(config-bgp-nbr)# commit`

Disables all active sessions for the specified neighbor, leaving the session disabled and still in the configuration.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Disable a BGP neighbor

Overview

Before you begin

Procedure

Example:

Example:

Example:

Need help?