Difference between revisions of "Main Page"

From VyOS Wiki
Jump to: navigation, search
 
(34 intermediate revisions by 5 users not shown)
Line 12: Line 12:
 
<div style="float: left; padding:5px; border:1px solid #ddd; margin-bottom: 5px; width: 100%; margin-bottom: 5px;">
 
<div style="float: left; padding:5px; border:1px solid #ddd; margin-bottom: 5px; width: 100%; margin-bottom: 5px;">
  
<p>[http://www.vyos.io VyOS] is a community fork of [http://en.wikipedia.org/wiki/Vyatta Vyatta], a Linux-based network operating system that provides software-based network routing, firewall, and VPN functionality.</p>
+
<p>[http://www.vyos.io VyOS] is a Linux-based network operating system that provides software-based network routing, firewall, and VPN functionality.</p>
  
 
<h3>How it's different from other router distros?</h3>
 
<h3>How it's different from other router distros?</h3>
* Unified command line interface in the style of hardware routers.
+
* Unified command line interface in the style of hardware routers.
 
* [[Configuration scripting|Scriptable CLI]]
 
* [[Configuration scripting|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...
 
* 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...
Line 43: Line 43:
 
<li>[[Report a bug]]</li>
 
<li>[[Report a bug]]</li>
 
<li>[[Editing guidelines]]</li>
 
<li>[[Editing guidelines]]</li>
<li>Commercial Support [https://vyos.io/professional-services/]</li>
+
<li>[[Events]]</li>
 
</ul>
 
</ul>
 
</div>
 
</div>
  
 
<div style="float: left; padding:5px; border:1px solid #ddd; width: 100%; margin-bottom: 5px;">
 
<div style="float: left; padding:5px; border:1px solid #ddd; width: 100%; margin-bottom: 5px;">
{{VyOS:Community_portal}}
+
 
 
</div>
 
</div>
  
Line 56: Line 56:
  
 
<div style="float: left; padding:5px; border:1px solid #ddd; width: 100%; margin-bottom: 5px;">
 
<div style="float: left; padding:5px; border:1px solid #ddd; width: 100%; margin-bottom: 5px;">
<h1> '''Project news''' </h1>
+
<h1> '''Wiki now closed for registrations due to migration''' </h1>
<rss max=5>http://blog.vyos.net/posts.atom</rss>
+
<p>Wiki now closed for registration.</p>
</div>
+
<p>Currently under migration to two different places:</p>
 
+
<p>- [https://vyos.readthedocs.io/en/latest/ VyOS Readthedocs]</p>
<div style="float: left; padding:5px; border:1px solid #ddd; width: 100%; margin-bottom: 5px;">
+
<p>- [https://support.vyos.io/en/kb VyOS KB]</p>
<h1> '''Wiki needs your contributions!''' </h1>
+
You can join effort at [https://github.com/vyos/vyos-documentation https://github.com/vyos/vyos-documentation]
 
 
If everyone reading this page documented just one command, VyOS would have complete [[User_documentation|user documentation]]
 
by next morning.
 
 
 
Registration and editing is open for everyone, you do not need to request access. Just [[Special:CreateAccount|create an account]]
 
and start editing right away.
 
 
 
Read the [[markup|formatting guide]] to learn the wiki syntax.
 
 
 
Click on any red link in the [[User_documentation|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 [[Special:AllPages|pages]]. All it needs is to be refactorized in the [[User_documentation|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 [[:Category:Interoperability|Interoperability]] category.
 
  
 
</div>
 
</div>
Line 88: Line 68:
 
<h1> '''Get the Software''' </h1>
 
<h1> '''Get the Software''' </h1>
  
<p>Current stable release: VyOS [[1.1.0/release_notes#1.1.7|1.1.7]] (Helium)</p>
+
<p>Current stable release: VyOS [[1.2.0/release_notes]] (Crux)</p>
  
 
Read about the [[semver|versioning scheme]].
 
Read about the [[semver|versioning scheme]].
 +
<h3>Сurrent Downloads: [https://support.vyos.io/en/downloads/vyos-1-2-x https://support.vyos.io] </h3>
  
<h3>Downloads: [http://mirror.vyos.net/iso/release/1.1.7 http://mirror.vyos.net/iso/release/1.1.7].</h3>
+
<h3>Legacy Downloads: [https://downloads.vyos.io/?dir=release/legacy/1.1.8 https://downloads.vyos.io].</h3>
* '''Physical and virtual 64-bit: [http://mirror.vyos.net/iso/release/1.1.7/vyos-1.1.7-amd64.iso]'''
+
* '''64-bit image: [https://downloads.vyos.io/release/legacy/1.1.8/vyos-1.1.8-amd64.iso vyos-1.1.8-amd64.iso]'''
* '''Legacy hardware 32-bit: [http://mirror.vyos.net/iso/release/1.1.7/vyos-1.1.7-i586.iso]'''
+
* '''32-bit image for legacy systems: [https://downloads.vyos.io/release/legacy/1.1.8/vyos-1.1.8-i586.iso vyos-1.1.8-i586.iso]'''
* '''VMWare OVA: [http://mirror.vyos.net/iso/release/1.1.7/vyos-1.1.7-amd64-signed.ova]'''
+
* '''OVA (works at least with VMware and VirtualBox): [https://downloads.vyos.io/release/legacy/1.1.8/vyos-1.1.8-amd64.ova vyos-1.1.8-amd64.ova]'''
* '''Virtual 32-bit: [http://mirror.vyos.net/iso/release/1.1.7/vyos-1.1.7-i586-virt.iso] (<strong>DEPRECATED</strong>)'''
 
  
<h3>Which image should I use?</h3>
 
* 64-bit physical machines: amd64.
 
* Virtual platforms (KVM, Xen, VMWare, Hyper-V): amd64 (drivers and tools included!).
 
* Legacy 32-bit machines without PAE: i586.
 
 
i586 image kernel is built without PAE support so it works on older CPUs often found in small embedded boards.
 
  
 
<h3>Upgrading from previous versions or Vyatta Core</h3>
 
<h3>Upgrading from previous versions or Vyatta Core</h3>
Line 111: Line 85:
  
 
<h4>Amazon EC2</h4>
 
<h4>Amazon EC2</h4>
<p>Amazon is a popular public cloud service where you can run your VMs and create private networks.</p>
+
<p>The official AMI is available here [https://aws.amazon.com/marketplace/pp/B07N3X1P1T/?ref=_ptnr_doc_ VyOS on AWS Marketplace]</p>
* [https://aws.amazon.com/marketplace/pp/B00JK5UPF6 VyOS on AWS Marketplace]
+
<h4>Microsoft Azure</h4>
 
+
<p>Official listing available here [https://azuremarketplace.microsoft.com/en-us/marketplace/apps/sentriumsl.vyos-1-2-lts-on-azure VyOS on Azure] </p>
  
 
<p>Please [https://phabricator.vyos.net/maniphest/task/edit/form/default/ send us] feedback if you find any bugs!</p>
 
<p>Please [https://phabricator.vyos.net/maniphest/task/edit/form/default/ send us] feedback if you find any bugs!</p>
Line 131: Line 105:
  
 
* [http://github.com/vyos View Git Repositories]
 
* [http://github.com/vyos View Git Repositories]
* Development Builds: '''[http://dev.packages.vyos.net/iso http://dev.packages.vyos.net/iso]'''
+
* Rolling Release: '''[https://downloads.vyos.io/?dir=rolling/current/amd64 https://downloads.vyos.io/?dir=rolling/current/amd64]'''
  
 
* Read how to [[submit a patch]]
 
* Read how to [[submit a patch]]
Line 139: Line 113:
 
** [[Howto build VyOS 1.2 ISO image and VMWare .OVF]]
 
** [[Howto build VyOS 1.2 ISO image and VMWare .OVF]]
 
* [[Rebuild VyOS kernel Step]]
 
* [[Rebuild VyOS kernel Step]]
* [[Development meetings]]
 
 
* [[Release procedure]]
 
* [[Release procedure]]
* [https://github.com/vyos/vyatta-dummy Package skeleton]
 
 
* [https://ci.vyos.net/ CI Server]
 
* [https://ci.vyos.net/ CI Server]
  
Line 154: Line 126:
 
</div>
 
</div>
 
</div>
 
</div>
 +
[[Category: Don't migrate]]

Latest revision as of 20:56, 3 July 2019


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.

Vyos session.png

Wiki now closed for registrations due to migration

Wiki now closed for registration.

Currently under migration to two different places:

- VyOS Readthedocs

- VyOS KB

You can join effort at https://github.com/vyos/vyos-documentation

Get the Software

Current stable release: VyOS 1.2.0/release_notes (Crux)

Read about the versioning scheme.

Сurrent Downloads: https://support.vyos.io

Legacy Downloads: https://downloads.vyos.io.


Upgrading from previous versions or Vyatta Core

Check out the upgrade instructions.

Cloud services

Amazon EC2

The official AMI is available here VyOS on AWS Marketplace

Microsoft Azure

Official listing available here VyOS on Azure

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.