Docs: Comprehensive BGP Configuration Guide

[sethesterline]

Summary

The current BGP documentation only covers adjusting hold down timers and lacks a comprehensive configuration guide with clear scenarios and complete UI element coverage.

Type

How-to Guide

Current State

The existing documentation (Adjusting BGP Timers) only covers:

• Configuring BGP hold down timers
• Basic steps to set IP Address Type to BGP/OSPF

Suggested Content

• Audience: Network administrators configuring dynamic routing in VergeOS
• Prerequisites: Basic understanding of BGP concepts, ASN assignment, network topology planning

Key sections to add:

1. BGP Overview in VergeOS

   • When to use BGP vs static routing
   • VergeOS BGP architecture (FRR-based)
   • Supported BGP features

2. Complete Configuration Scenario

   • End-to-end example: VergeOS peering with upstream router
   • Multi-homed BGP configuration
   • BGP with tenants

3. UI Element Reference

   • All fields in the External Network BGP/OSPF configuration
   • Router configuration options (ASN, timers, neighbors)
   • FRR command reference for common operations

4. Neighbor Configuration

   • Adding BGP neighbors/peers
   • Authentication options
   • Route filtering and prefix lists

5. Route Advertisement

   • Advertising networks to BGP peers
   • Route maps and policies
   • Redistribution options

6. Verification and Troubleshooting

   • Using Network Diagnostics > FRRouting BGP/OSPF
   • Common show commands
   • Troubleshooting peer establishment issues

7. Best Practices

   • Timer recommendations
   • Security considerations
   • High availability configurations

Context

Requested via support interaction. Current documentation gap makes it difficult for administrators to implement BGP without extensive FRR knowledge or trial-and-error configuration.

[b0rbb]

I would love to help out with this, I can totally provide diagrams too (And I promise I'll provide them this time 😭).