VyOS Crash Course
VyOS is an open-source network operating system based on Debian. It provides a unified CLI for routing, firewall, VPN, NAT, and more — similar to Juniper JunOS or Cisco IOS but running on standard x86 hardware or VMs.
If you’ve ever used EdgeOS (Ubiquiti EdgeRouter), you already know VyOS — EdgeOS is a fork. VyOS is the upstream, community-maintained original.
Why VyOS?
| vs. | VyOS wins because |
|---|---|
| pfSense/OPNsense | CLI-first, declarative config, commit/rollback, API-ready |
| MikroTik RouterOS | Linux under the hood, standard tooling, no license tiers |
| Cisco/Juniper | Free, runs on any x86, same routing concepts |
| iptables/nftables | Unified config syntax, zone-based firewall, stateful commit |
What you’ll learn
- Installation — ISO, cloud images, VPS deployment
- Basic Configuration — hostname, users, interfaces, SSH
- NAT & Firewall — zone-based firewall, source NAT, port forwarding
- DHCP & DNS — DHCP server, DNS forwarding, dynamic DNS
- VPN — WireGuard, IPsec IKEv2, site-to-site and road warrior
- Routing — static routes, BGP, OSPF
- High Availability — VRRP, config sync, stateful failover
- Configuration Backup with Git — auto-backup config on every commit
- Image Automation — custom ISO builds, cron pipelines, CI/CD
- Syslog to Graylog — centralized logging, Grok extractors, dashboards
Release tracks
| Channel | Version | Status | Access |
|---|---|---|---|
| Rolling | 1.5 Circinus | Active development | Free |
| Stream | 1.5 (quarterly) | LTS preview, stable | Free |
| LTS | 1.4 Sagitta | Current LTS | Contributor/paid |
| LTS (old) | 1.3 Equuleus | Maintenance only | Contributor/paid |
This guide targets VyOS 1.4/1.5. Configuration syntax differs from 1.3 (Equuleus). The historical 1.3 migration URL returned HTTP 404 on 2026-11-05. No equivalent migration guide was confirmed. The official 1.4 image-update guide describes image management, not complete 1.3 configuration migration. Obtain version-specific migration and recovery guidance from the VyOS maintainer before upgrading a 1.3 installation.
Quick reference
# Enter configuration mode
configure
# Set hostname
set system host-name vyos-router
# Commit and save
commit
save
# Exit configuration mode
exit
# Show current config
show configuration
# Show version
show version