Skip to content

esoadamo/mikrotik-easy-web-ui

Repository files navigation

Mikrotik Easy-Web UI

WEB UI screenshot

Features

  • shows active clients
  • shows current download/upload usage per client
  • can limit maximal usage for whole network/single device
  • automatic DoH heartbeat check
  • local copy of router log
  • router error notifications
  • high CPU usage notification
  • available update notification
  • dns monitor for accessing bad domains

Installation

Account creation

  1. create new user group (api) with following permissions: reboot, read, write, policy, test, sniff, api
  2. create new user (api) and assign him to the created group

Software installation

# 1. clone the repository
git clone https://github.com/esoadamo/mikrotik-easy-web-ui.git
cd mikrotik-easy-web-ui
# 2. (optional) create venv
python -m venv venv
# 3. install requirements
pip install -r requirements.txt
# 4. edit settings
cp .env.sample .env
nano .env
# 5. (optional) implement notification service
cp notification.sample.py notification.py  # and then edit function send_notification 

Troubleshooting

No client names (just IP adresses instead of them)

Client names should be set as comments inside IP -> DHCP Server -> Leases -> {client}

Limits are not working

Disable fasttrack. IP -> Firewall -> Filter Rules -> Fasttrack

DNS not working when AUTO_DOH is enabled

Make sure that you have downloaded and imported correct certificate for your DOH server

Missing bdist_wheel during installation

On Ubuntu, you need to make sure that you have following packages installed:

sudo apt-get install python3-dev python3-pip python3-venv python3-wheel -y

About

An easy interface for your home network

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published