Main Page
Welcome to the VyOS project, a Linux-based network operating system.
VyOS is a Linux-based network operating system that provides software-based network routing, firewall, and VPN functionality.
How it's different from other router distros?
- Unified command line interface in the style of hardware routers.
- Scriptable CLI
- Stateful configuration system: prepare changes and commit at once or discard, view previous revisions or rollback to them, archive revisions to remote server, execute hooks at commit time...
- Image-based upgrade: keep multiple versions on the same system and revert to previous image if something went wrong.
- Not just firewall and VPN: includes routing protocols such as BGP and OSPF and complex routing policy language.
- Runs on physical and virtual platforms alike: small x86 boards, big servers, KVM, Xen, VMWare, Hyper-V...
- Completely free and open source, with documented internal APIs and build procedures.
- Community driven: patches are welcome, all code, bugs, and nightly builds are public.
What can it do?
See the feature list.
What it looks like?
Here's a command line session example.
Getting Started
Project news
- The "operator" level is proved insecure and will be removed in the next releases
- — Daniil Baturin 2018-11-01 19:37:42
- VyOS 1.2.0-rc5 is available for download
- — Daniil Baturin 2018-11-01 19:28:41
- VyOS 1.2.0-rc4 is available for download
- — Daniil Baturin 2018-10-31 10:56:23
- VyOS 1.2.0-rc3 is available for download, with BGP large communities and new bugfixes
- — Daniil Baturin 2018-10-29 06:01:23
- VyOS 1.2.0-rc2 is available for download, with fixes to wireguard and PBR
- — Daniil Baturin 2018-10-14 20:51:52
Wiki needs your contributions!
If everyone reading this page documented just one command, VyOS would have complete user documentation by next morning.
Registration and editing is open for everyone, you do not need to request access. Just create an account and start editing right away.
Read the formatting guide to learn the wiki syntax.
Click on any red link in the user documentation or create new page.
The most straightforward way to expand the wiki is to rewrite the old VC6.5 documentation, since VyOS remains backwards-compatible with VC6.5. However, do not copy anything verbatim from it, since it's not under a free license, write in your own words.
Lot of usefull data is already present in existing pages. All it needs is to be refactored in the user documentation.
You can also document specific setup and use cases, and add examples of configuring VyOS to interact with other systems,
such as those from the Interoperability category.
Get the Software
Current stable release: VyOS 1.1.8 (Helium)
Read about the versioning scheme.
Downloads: https://downloads.vyos.io/?dir=release/1.1.8.
- 64-bit image: https://downloads.vyos.io/release/1.1.8/vyos-1.1.8-amd64.iso
- 32-bit image for legacy systems: https://downloads.vyos.io/release/1.1.8/vyos-1.1.8-i586.iso
- OVA (works at least with VMware and VirtualBox): https://downloads.vyos.io/release/1.1.8/vyos-1.1.8-amd64.ova
Upgrading from previous versions or Vyatta Core
Check out the upgrade instructions.
Cloud services
Amazon EC2
The official AMI is available, starting at $64/year per instance: VyOS on AWS Marketplace
You can also build your own AMI from the ISO image using these scripts: vyos/build-ami
Please send us feedback if you find any bugs!
Distribution infrastructure
You can verify the build signature against our public key.
VyOS images are hosted on multiple mirrors for better availability.
Development
VyOS uses Phabricator to coordinate development activities.
- Read how to submit a patch
API reference:
