zdc 00faafed96
VPP: Add comprehensive VPP documentation
This commit introduces extensive documentation for VyOS VPP (Vector Packet Processing)
Dataplane interfaces and features, including examples.

Features documented:
* VPP integration description, base requirements and limitations
* VPP dataplane core settings
* Features enabled in the dataplane: ACL, IPsec, NAT, sFlow
* VPP interface types: bonding, bridge, GRE, IPIP, kernel, loopback, VXLAN, XConnect

Note: This is an initial documentation version that will require ongoing improvements
based on user feedback and questions, real-world deployment testing and validation, additional
use cases and configuration scenarios discovered in production. Therefore, all pages are
marked as "need improvement".
2025-09-04 19:02:26 +03:00

106 lines
2.5 KiB
ReStructuredText

.. _index:
###############
VyOS User Guide
###############
.. grid:: 3
:gutter: 2
.. grid-item-card:: Get / Build VyOS
Quickly :ref:`Build<contributing/build-vyos:build vyos>` your own Image or take a look at how to :ref:`download<installation/install:download>` a free or supported version.
.. grid-item-card:: Install VyOS
Read about how to install VyOS on :ref:`Bare Metal<installation/install:installation>` or in a
:ref:`Virtual Environment<installation/virtual/index:Virtual Environments>` and
how to use an image with the usual :ref:`cloud<installation/cloud/index:Cloud Environments>` providers
.. grid-item-card:: Configuration and Operation
Use the :ref:`Quickstart Guide<quick-start:Quick Start>`, to have a fast overview. Or go deeper and
set up :ref:`advanced routing<configuration/protocols/index:protocols>`,
:ref:`VRFs<configuration/vrf/index:vrf>`, or
:ref:`VPNs<configuration/vpn/index:vpn>` for example.
.. grid-item-card:: Automate
Integrate VyOS in your automation Workflow with
:ref:`Ansible<vyos-ansible>`,
have your own :ref:`local scripts<command-scripting>`, or configure VyOS with the :ref:`HTTPS-API<vyosapi>`.
.. grid-item-card:: Examples
Get some inspiration from the :ref:`Configuration Blueprints<configexamples/index:Configuration Blueprints>`
to build your infrastructure.
.. grid-item-card:: Contribute and Community
| There are many ways to contribute to the project.
| Add missing parts or improve the :ref:`Documentation<documentation:Write Documentation>`.
| Discuss in `Slack <https://slack.vyos.io/>`_ or the `Forum <https://forum.vyos.io>`_.
| Or you can pick up a `Task <https://vyos.dev/>`_ and fix the :ref:`code<contributing/development:development>`.
.. toctree::
:hidden:
:maxdepth: 1
introducing/about
introducing/history
changelog/index
.. toctree::
:maxdepth: 2
:hidden:
:caption: First Steps
installation/index
quick-start
cli
.. toctree::
:maxdepth: 2
:hidden:
:caption: Adminguide
configuration/index
operation/index
automation/index
troubleshooting/index
configexamples/index
vpp/index
.. toctree::
:maxdepth: 2
:hidden:
:caption: Development
contributing/build-vyos
contributing/development
contributing/issues-features
contributing/upstream-packages
contributing/debugging
contributing/testing
.. toctree::
:maxdepth: 2
:hidden:
:caption: Misc
documentation
coverage
copyright