vycontrol

VyControl

• VyOS frontend made in Python / Django using VyOS new 1.3 API server
• Check out website at https://www.vycontrol.com/

It will work with a single VyoS server or to multiple VyOS servers, so datacenters which do not want share same firewall to different customers will not need to install several VyControl to each customer. That's why the name VyControl.

community, help and development

• Slack Channel https://vycontrol.slack.com/archives/C012ZRMB8VB
• VyControl discussion at VyOS forum https://forum.vyos.io/t/vycenter-alpha-stage-announcement-vyos-web-interface/5221/4
• Feature requests, bugs please add at https://github.com/vycontrol/vycontrol/issues
• Forks and pull requests are welcome!

roadmap

current version

• 20.05.01 - version created to start project framework, organize permission systems and concept test with some firewall and interface functions and statics routes

future versions

• 20.05.02 - working firewall without zones
• 20.05.07 - vlans / interfaces deep configuration
• 20.05.10 - working firewall with zones
• 20.06.01 - commit, save, load and system login
• 20.06.03 - granular permissions and improvements
• 20.06.09 - save/commit/load features and ssh / logins
• 20.06.10 - lost password
• 20.06.13 - ipsec features
• 20.06.15 - layout
• 20.06.20-LTS - OSPF features
• 20.08.01 - s3 backup scheduler and commit confirm
• 20.12.10 - ipv6 milestone
• 20.12.20 - depend on a third party

lifecycle

• initially LTS (Long Term Support) versions will be supported by 6 months just to bugfixes
• in the future we will extend the time span of LTS versions

installation

• for your security edit SECRET_KEY and change to something random

by dockerhub

latest VyControl is being autobuilt at dockerhub https://hub.docker.com/r/robertoberto/vycontrol

docker pull robertoberto/vycontrol

by docker composer

Right now we are using db.sqlite3, but I used composer so we can change to mySQL if needed.

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

setup initial database

cd vycenter
python3 manage.py migrate

run webserver

python3 manage.py runserver

access webpage

http://127.0.0.1:8000/

setup vyos new instance

• click on Add new instance
• configure vyos services like explained here https://docs.vyos.io/en/latest/appendix/http-api.html
• click on List Instances
• click on Test Connection

references

• https://docs.vyos.io/en/latest/appendix/http-api.html
• https://forum.vyos.io/t/http-api-for-show/3922
• https://blog.vyos.io/vyos-rolling-release-has-got-an-http-api

screenshoots (keep in mind we're in early alpha stages)

Install VyControl

List Users

List VyOS Instances

Add VyOS Instances

List Interfaces

List Firewall

Add Firewall Rule

List Static Routes

Sponsoring

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