An advanced Home Assistant integration for Keenetic routers. Provides mesh network management, VPN control, device tracking, and more.

• Real-time device status via ICMP Ping. You don't need to wait Keenetic's update time for device tracking. This integration ping the devices you selected in every 3 seconds.
• Selectable client list
• 3-seconds update interval
• Automatic updates on IP address changes

• Status of all extenders/repeaters (binary sensors)
• Separate reboot button for each mesh node
• CPU, RAM, and uptime information
• Firmware update notification (update available sensor)
• Number of connected clients (associations)

• Enable/disable WireGuard profiles (switch)
• OpenVPN, IPsec, L2TP, PPTP support
• VPN uptime, RX/TX sensors

• Enable/disable switch for each SSID
• Guest WiFi control

• Real WAN IP address (PPPoE supported)
• Connection status sensor
• Uptime information

• Number of connected / disconnected devices

• Connection Policy selection (per client)

  • Default, VPN, No VPN, Smart Home, Roblox, etc.
  • Deny (block internet access)

• Event trigger when a new device connects

• Router reboot
• Mesh node reboot (separate for each node)

1. HACS > Integrations > ⋮ > Custom repositories
2. URL: https://github.com/YOUR_USERNAME/keenetic_router_pro
3. Category: Integration
4. Search for "Keenetic Router Pro" and install
5. Restart Home Assistant

1. Copy the keenetic_router_pro folder into config/custom_components/
2. Restart Home Assistant

To use this integration securely, it is strongly recommended to configure Firewall rules and Port Forwarding properly on your Keenetic router. This section explains why it matters and how to do it.

• Home Assistant communicates with the router via its web management API

• Exposing router services directly to the internet without restrictions is a security risk

• Proper firewall rules ensure:

  • Only trusted devices (Home Assistant) can access the router
  • No unintended WAN access to router management services

Think of the firewall as a bouncer with a clipboard. Only invited guests get in.

1. Enable UPnP if it is not
2. Go to Internet > Port forwarding
3. Add a new rule:

🚫 Never expose port 80/443 to WAN without firewall rules

Use Firewall rules to restrict access.

1. Go to Network Rules > Firewall
2. Create a new rule for your PPPoE connection:

3. Create a second rule:

✅ Ensure only Home Assistant can talk to the router API.

Settings > Devices & Services > Add Integration > Keenetic Router Pro

During setup, you can choose which devices should be monitored via ping.

Triggered when a new device connects to the network.

automation:
  - alias: "New Device Notification"
    trigger:
      - platform: event
        event_type: keenetic_router_pro_new_device
    action:
      - service: notify.mobile_app
        data:
          title: "🆕 New Device Connected"
          message: "{{ trigger.event.data.name }} ({{ trigger.event.data.ip }})"

Event Data:

• mac: MAC address
• name: Device name
• ip: IP address
• hostname: Hostname
• interface: Connected interface
• ssid: WiFi SSID (if applicable)

• 🇬🇧 English
• 🇹🇷 Turkish
• 🇷🇺 Russian

• Home Assistant 2024.1.0 or newer
• Keenetic router (NDMS 3.x / 4.x / 5.x)
• Web management interface must be enabled on the router

• Keenetic Ultra (KN-1810)
• Keenetic Hopper (KN-3810)
• Keenetic Buddy 5 (KN-3311)
• Keenetic Air (KN-1610)

1. Verify router IP address and port
2. Verify username and password
3. Ensure the web interface is enabled on the router

1. Restart Home Assistant
2. Remove and re-add the integration

• Home Assistant must have permission for ICMP ping
• Docker installations may require network_mode: host

MIT License

⭐ If you like this project, don’t forget to give it a star!