# VyOS

> VyOS is a free, open-source network operating system based on Debian GNU/Linux.
> It provides routing, firewall, and VPN functionality via a unified CLI using
> `set`/`delete`/`show` command hierarchy. This documentation covers 1.5.x (circinus).

VyOS configuration follows a tree structure. All configuration commands start with
`set` (to add/change) or `delete` (to remove). Changes are staged and applied with
`commit`. The CLI hierarchy maps directly to the documentation structure.

## Quick Start

- [Quick Start Guide](https://docs.vyos.io/en/1.5/quick-start.md): Minimal setup walkthrough
- [CLI Overview](https://docs.vyos.io/en/1.5/cli.md): Command-line interface usage

## Configuration

- [Firewall](https://docs.vyos.io/en/1.5/configuration/firewall/index.md): Zone-based firewall, rules, groups
- [Interfaces](https://docs.vyos.io/en/1.5/configuration/interfaces/index.md): Ethernet, bonding, bridge, VLAN, tunnel, wireless
- [Protocols](https://docs.vyos.io/en/1.5/configuration/protocols/index.md): BGP, OSPF, IS-IS, static routing, MPLS
- [VPN](https://docs.vyos.io/en/1.5/configuration/vpn/index.md): IPsec, OpenVPN, WireGuard, L2TP, PPTP
- [NAT](https://docs.vyos.io/en/1.5/configuration/nat/index.md): Source NAT, destination NAT, NAT66
- [System](https://docs.vyos.io/en/1.5/configuration/system/index.md): DNS, NTP, syslog, users, task scheduler
- [High Availability](https://docs.vyos.io/en/1.5/configuration/highavailability/index.md): VRRP
- [Load Balancing](https://docs.vyos.io/en/1.5/configuration/loadbalancing/index.md): WAN and reverse proxy
- [Containers](https://docs.vyos.io/en/1.5/configuration/container/index.md): Podman-based container support
- [PKI](https://docs.vyos.io/en/1.5/configuration/pki/index.md): Certificate management
- [Policy](https://docs.vyos.io/en/1.5/configuration/policy/index.md): Route maps, prefix lists, access lists
- [Traffic Policy](https://docs.vyos.io/en/1.5/configuration/trafficpolicy/index.md): QoS and shaping
- [Service](https://docs.vyos.io/en/1.5/configuration/service/index.md): DHCP, DNS forwarding, SNMP, SSH, HTTPS API
- [VRF](https://docs.vyos.io/en/1.5/configuration/vrf/index.md): Virtual routing and forwarding

## Operations

- [Operational Commands](https://docs.vyos.io/en/1.5/operation/index.md): Show, monitor, restart commands

## Installation

- [Installation Guide](https://docs.vyos.io/en/1.5/installation/index.md): Bare metal, virtual, cloud deployments

## Automation

- [Automation](https://docs.vyos.io/en/1.5/automation/index.md): Ansible, Terraform, HTTP API, NETCONF

## Configuration Examples

- [Blueprints](https://docs.vyos.io/en/1.5/configexamples/index.md): Real-world topology examples

## Optional

- [Contributing](https://docs.vyos.io/en/1.5/contributing/index.md): Development workflow
- [VPP](https://docs.vyos.io/en/1.5/vpp/index.md): Vector Packet Processing integration