07.06.2023

Connecting VyOS server to a network

This guide describes how to configure a VyOS server in private network.

VyOS VDS's are often used as routers and can handle VPNs of different types and configurations.

Setup

After VPS connection to a LAN in a control panel, connect to the server over ssh and enter VyOS configuration mode:

config

Note: In normal mode, some utilities are unavailable and command prompt ends up with “$“, while in configuration mode it ends up with “#“.

Display all available interfaces:

show interfaces
ethernet eth0 {
address XXX.XXX.XXX.XXX /24
duplex auto
hw-id
smp_affinity auto
speed auto
}
ethernet eth1 {
duplex auto
hw-id
smp_affinity auto
speed auto
} loopback lo {
}

Use set command to set local IP address; if DHCP option is disabled for the network, then take an address from a control panel on your VPS settings tab and set it as a value (see figure below):

set interfaces ethernet eth1 address /24


For example:

set interfaces ethernet eth1 address 10.0.0.2/24

If DHCP option is enabled, execute the following command:

set interfaces ethernet eth1 address dhcp

Note: If an error is returned, try including a current user in a superuser group (for example, usermod -a -G root ).

Check modifications:

show interfaces
ethernet eth1 {
+ address /
duplex auto
hw-id 00:50:56:01:1b:9f
smp_affinity auto speed auto
}
loopback lo {
}

Modified lines are marked with “+”.

If everything is OK, then commit and save changes:

commit
save

Exit configuration mode:

exit

Check the configured local IP address of VyOS interface:

show interfaces
Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down
Interface
---------
eth0
eth1
lo
IP Address
----------
XXX.XXX.XXX.XXX/24
10.0.0.2/24
127.0.0.1/8
::1/128
S/L
---
u/u
u/u
u/u
Description
-----------

Now, you can use the configured machine as a router or other node in a private network.