---
id: aioruckus
version: "0.46.3"
license: 0BSD
license_treatment: permissive
maintenance: active
---

# aioruckus — Python API to interact with Ruckus Unleashed and ZoneDirector devices

License: permissive · Maintenance: active · Downloads: 76.9K/mo

## What it is and what it does

aioruckus is an async Python client for the Ruckus Unleashed and ZoneDirector wireless controller AJAX API. It lets you query device configuration (APs, WLANs, client lists, mesh topology, system info) and perform administrative actions (enable/disable WLANs, block/unblock clients, restart APs, manage WLAN groups) programmatically. The library wraps HTTP calls to the controller's web service and parses XML responses into Python objects.

The package is built on aiohttp for async HTTP, cryptography for secure communication, and xmltodict for XML parsing. It also supports reading backed-up Ruckus configuration files directly without network access. All API calls are async context-manager based, so you must use asyncio to call them—there is no synchronous interface.

Use it for:

- Automate wireless network monitoring and alerting by querying AP stats, client counts, and system alarms on a schedule.
- Build a custom dashboard or integration layer that pulls live WLAN and client data from Ruckus controllers into your monitoring stack.
- Programmatically manage WLAN groups, SSIDs, and security settings across multiple Ruckus devices in a deployment.
- Block or unblock client devices and manage rogue AP detection as part of a larger network security workflow.
- Parse and audit Ruckus backup files to extract configuration details without connecting to a live device.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Async Python client library for querying and controlling Ruckus Unleashed and ZoneDirector wireless devices via their AJAX Web Service interface, and for reading backed-up configuration files.

Yes, if you need to integrate Ruckus Unleashed or ZoneDirector devices into a Python automation or monitoring workflow. The package is actively maintained, has no known vulnerabilities, installs cleanly, and covers a broad API surface for both read and write operations. The Python 3.12+ requirement is the main constraint; verify your environment supports it before installing.

## Install

pip install aioruckus
uv add aioruckus
poetry add aioruckus

## Installing aioruckus

Before you install: Low install friction with a pure-Python wheel and three common async dependencies (aiohttp, cryptography, xmltodict). Actively maintained with a recent release; requires Python 3.12 or later.

License in practice: Licensed under 0BSD (permissive), so you can use, modify, and distribute the package with minimal restrictions.

Quickstart:

pip install aioruckus

from aioruckus import AjaxSession
import asyncio

async def example():
    async with AjaxSession.async_create("host", "user", "pass") as session:
        aps = await session.api.get_aps()
        print(aps)

asyncio.run(example())

Requires Python 3.12 or later and an accessible Ruckus Unleashed or ZoneDirector device (version 9.10+).

Verify before relying:

- Whether the package works with ZoneDirector versions between 9.10 and the latest tested version.
- Performance characteristics when querying large numbers of clients or events across many APs.

## Package facts

- License: 0BSD (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ruckus unleashed api client, ruckus zonedirector python, wireless network management api, async ruckus device control, ruckus configuration query, ruckus wlan management, network device api python, wireless-management, network-automation, async-api

[View on SkillFed](https://skillfed.io/packages/aioruckus) · [View on PyPI](https://pypi.org/project/aioruckus/)