---
title: "Cudy Router"
description: "Cudy Router is a Marketplace integration for Home Assistant. It has 169 installs sharing analytics, works locally and was last updated October 24, 2026."
canonical: "https://vulpo.app/integrations/marketplace/usersaynoso-ha-cudy-router"
url: "https://vulpo.app/integrations/marketplace/usersaynoso-ha-cudy-router.md"
last-updated: "2026-10-25"
version: "1.4"
---

# Cudy Router

> Cudy Router is a Marketplace integration for Home Assistant. It has 169 installs sharing analytics, works locally and was last updated October 24, 2026.

Cudy Router is an integration that connects Home Assistant to Cudy routers with a LuCI-based web interface. It polls the router locally and turns its status pages into sensors for modem, WAN, LAN, DHCP, VPN, Wi-Fi, SMS and traffic, depending on model and firmware. It also adds a reboot button, a LED switch, selects for writable router settings, and actions for sending SMS, sending AT commands, restarting the 5G connection and switching the 5G band. Mesh nodes appear as separate devices, and connected clients can be added automatically or picked from a list, with optional device trackers. Routers with SMS support also get a sidebar panel for reading and composing messages, which can be hidden in the options. Setup is done in the UI with the router address, username and password.

Automatic summary of the README and code of usersaynoso/ha-cudy-router. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=usersaynoso&repository=ha-cudy-router&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=usersaynoso&repository=ha-cudy-router&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Add new router

- **Router IP address**: The IP address of your router (e.g., 192.168.10.1)
- **Password**
- **Username**

### Reconnect to Cudy Router

- **Password**
- **Username**

### After setup

- **Automatically add connected devices**: Create client devices and live client entities for every currently connected device. Disabled by default for new integrations. Turn this on to automatically create client devices and live per-client entities, or leave it off to only create them for devices listed below.
- **Automatically add device trackers for connected devices**: Create device\_tracker entities for every currently connected device with a MAC address. Disabled by default. Turn this on if you want presence-style trackers in addition to the live client entities.
- **Show Cudy SMS in sidebar**: Show the Cudy SMS panel link in the Home Assistant sidebar. Disable this to keep the SMS page available only by direct URL.
- **Update interval**: How often to poll the router for updates (in seconds)
- **Manually add connected devices**: Select connected clients from a list when automatic connected-device discovery is turned off. Selected manual devices stay in Home Assistant when offline and become unavailable until the client reconnects. Legacy text-based values are still honored until you save this picker.
- **Tracked devices**: Select specific connected clients that should always keep a device\_tracker entity. When automatic connected-device discovery is off, this picker shows the manual connected devices selected on the previous step, or all live connected clients when no manual connected devices are selected. Selected trackers stay available across reloads and show away/not\_home when the client is offline.

Texts from the code of [usersaynoso/ha-cudy-router](https://github.com/usersaynoso/ha-cudy-router).

## Entities

- **Buttons**: Reboot
- **Sensors**: Mesh devices, Name, Model, MAC address, Firmware, Status, IP address
- **Switches**: LED

## Actions

- **Reboot router**: Reboots the Cudy router.
  Fields: Config entry ID
- **Restart 5G connection**: Restarts the 5G modem connection by triggering a modem reset.
  Fields: Config entry ID
- **Switch 5G band**: Changes the 5G band setting on the router.
  Fields: Config entry ID, Band
- **Send SMS**: Sends an SMS message via the router's cellular modem.
  Fields: Config entry ID, Phone number, Message
- **Send AT command**: Sends a raw AT command to the router's cellular modem.
  Fields: Config entry ID, Command

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## From the README

> cudy\_router is a community-built Home Assistant integration for Cudy routers that expose a LuCI-based web interface.
>
> It connects directly to the router over your local network, reads the same status and configuration pages you see in the browser, and turns them into Home Assistant entities, devices, and services.
>
> - Local polling integration with Home Assistant config flow and options flow.
> - Router-wide sensors for modem/cellular, WAN, LAN, DHCP, VPN, load balancing, Wi-Fi, SMS, traffic, and system status, including CPU/RAM usage when the router reports it.
> - Writable router settings exposed as Home Assistant switch and select entities when the router supports them.
> - WISP uplink scan and connect on supported models: a WISP scan button, a WISP network picker, a write-only WISP password field, and a WISP connect button.
> - Reboot buttons and services for SMS, AT commands, 5G connection restart, and band switching.
> - Mesh node support with separate Home Assistant devices, per-node LED control, and per-node reboot.
> - Connected client devices, per-client controls, and optional device\_tracker entities.
> - Automatic config entry migration from older versions.

From the README of [usersaynoso/ha-cudy-router](https://github.com/usersaynoso/ha-cudy-router#readme), [GNU GPL v3.0](https://spdx.org/licenses/GPL-3.0.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), Routers and network
- Number: 169 installs sharing analytics; 17 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v1.3.38, last updated October 24, 2026
- Domain: `cudy_router`
- Source: <https://github.com/usersaynoso/ha-cudy-router>
- Issues: <https://github.com/usersaynoso/ha-cudy-router/issues>

In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-25. Source: https://vulpo.app/integrations/marketplace/usersaynoso-ha-cudy-router

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/usersaynoso-ha-cudy-router
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml
