Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


VyControl is web frontend interface to manage a single or multiple VyoS servers. It is developed in Python/Django using VyOS API.

Future Roadmap

VyControl currently is deprecated since VyOS will bring a new API.

Use Cases:

VyControl can be a web gui for one single VyOS installation, but it requires a separeted webserver from VyOS to a single network admin user or a TI department from a company

VyControl can be a web gui for multiple VyOS installation in a same enterprise, to a single network admin user or a TI department from a company

VyControl can be a web gui for multiple VyOS installation in a datacenter. Each of datacenter customer have a VyControl user to manage their own VyOSes (each user can manage several VyOS).

Main links

  • VyControl website
  • VyOS linux firewall website (only compatible with rolling release / 1.3 VyOS)
  • Reddit

Plan to use VyControl?

Install instructions

  • download VyOS Rolling Release, since VyControl needs the latest VyOS API.
  • configure VyOS-API according VyOS documentation


latest VyControl is being autobuilt at dockerhub

download latest docker image:

docker pull robertoberto/vycontrol

run docker:

docker run -p 8000:8000 -t robertoberto/vycontrol

now you can access

by docker compose

Right now we are using db.sqlite3, you can edit composer and to change to mySQL/PostgreSQL if needed.

find vycontrol | grep migrations | xargs rm -rf
docker-compose build
docker-compose up

manual install instructions

setup virtual env and pip requirements

virtualenv env
source env/bin/activate
pip3 install -r requirements.txt

create your own configuration

cp -a vycontrol/vycontrol/settings_example/ /vycontrol/vycontrol/settings_available/

edit according your needs:

  • ALLOWED_HOSTS currently is ok for tests
  • for tests you don't need to edit EMAIL settings, but forget password will not work
  • sqlite is ok for tests, but you can change to MySQL/PostgreSQL.
  • SECRET_KEY edit to anything random, you can use openssl for example:
openssl rand -hex 32

setup initial database

source env/bin/activate
cd vycontrol
python3 makemigrations config --settings=vycontrol.settings_available.production 
python3 makemigrations --settings=vycontrol.settings_available.production 
python3 migrate --settings=vycontrol.settings_available.production 

run webserver

source env/bin/activate
cd vycontrol
python3 runserver --settings=vycontrol.settings_available.production

access webpage

setup vyos new instance

  • click on Add new instance
  • configure vyos services like explained here
  • click on List Instances
  • click on Test Connection

setup email provider

VyControl send email to users when they click on Forget Password. So you need to setup a email provider to be able to use this features.

  • edit vycontrol/settings/
  • change according your mail provider, you can use gmail accounts, sendergrid, amazon ses, mailgun etc

Plan to help develop VyControl?


  • create/read/update/delete users
  • create/read/update/delete groups
  • create/read/update/delete DNS Resolver
  • create/read/update/delete email/password in user profile
  • create/read/update/delete interfaces and vlans
  • lost password recovery using external SMTP server
  • create/read/update/delete NTP Serrves
  • create/read/update/delete zone based firewall
  • improve firewall UI and error returns to end users
  • working firewall
  • version created to start project framework, organize permission systems and concept test with some firewall and interface functions and statics routes


vpn services

  • openvpn
  • ipsec

basic router configuration

  • ssh service
  • logins
  • hostname
  • domain-name
  • timezone

dynamic routing

  • OSPF
  • BGP

addons features

  • FastNetMon integration
  • save/commit/load
  • s3 backup scheduler


  • ipv6



Install VyControl

Install VyControl

List Users

List Users

List VyOS Instances

List VyOS Instances

Add VyOS Instances

Add VyOS Instances

List Interfaces

List Interfaces

List Firewall

List Dashboard

Add Firewall Rule

Add Firewall Rule

List Static Routes

List Static Routes


  • VyControl is being tested at Under a Brazilian provider of Cloud Computing and Datacenters.