QManager Mark
QManager
v0.1.35•Built for Qualcomm 5G Modems

High-speed 5G made simple.

Manage and optimize your Quectel modem with a clean, friendly dashboard. Easy setup for home routers, powerful tools when you want them.

Get Started in 2 MinutesBrowse GuidesGitHub(opens in a new tab)
Peak 5G-A downlink
7.5 Gbps
Guides in 8 categories
41
One-line setup
< 2 min
Qualcomm families
3 Gens
QManager modem overview on an RM520N-GL: connected on 5G-NSA, bands B1 and N41, 80 MHz bandwidth

Popular tasks & guides

Direct, practical tutorials for the most widely used modem optimization workflows.

Boost Signal & Aim Antennas

Live signal meter to help you point and position directional antennas for peak RSRP and SINR.

Read guide

Lock Fast Bands & Towers

Pin your connection to the fastest 5G & LTE frequency bands or lock onto specific cell towers.

Read guide

Automated Watchdog

Self-healing recovery daemon that monitors latency and automatically restores dropped links.

Read guide

Remote Mesh Access

Securely monitor and configure your modem from anywhere over Tailscale or Netbird VPN.

Read guide

Modem & hardware compatibility

Built for Quectel 5G modems with Qualcomm Snapdragon chips. Here is what has been tested, and how thoroughly.

Officially supported

The reference hardware QManager is built on.

  • RM551E-GL
  • RM520N-GL

Tested by the developer

Checked on real hardware, not a reference platform.

  • RG501Q-EU

Community-reported

Same Qualcomm platform, not validated by the developer.

  • RM521F
  • RM502Q
  • RM500Q

Not supported: Quectel modems on ASR, Unisoc or MediaTek chips (such as RG500U, EC200, EG25). Older Qualcomm LTE modems (X20/X24, such as EM120K/EM160R) are untested.

How we test hardware

The on-modem build (QManager-RM520N) is developed on the RM520N-GL reference platform and has been tested on an RG501Q-EU. Modems on the same Qualcomm SDX55/SDX6X platform (RM521F, RM502Q, RM500Q) share the same Linux and AT command set, but the developer has not validated them. Older Qualcomm X20/X24 modems are untested.

Running QManager on one of these? Community reports help everyone.

Share hardware feedback(opens in a new tab)

Snapdragon X75

RM551E-GL

Officially supported

The newest Quectel 5G modem. QManager runs on the modem's own OpenWRT.

Install for RM551E

Snapdragon X62 / X65

RM520N-GL

Officially supported

QManager's main development modem. Runs on its built-in Linux.

Other models on this build

  • RM521FExperimental
Install for RM520N

Snapdragon X55

RG501Q-EU

Tested by the developer

Earlier 5G modems. Uses the RM520N build.

Other models on this build

  • RM502QCommunity-reported
  • RM500QCommunity-reported
Install for RM520N

Standalone 5G-to-Ethernet boards work with any router that has a WAN port

Put the modem in an Ethernet carrier board and plug the board into your router's WAN port. The board shows up as ordinary Ethernet, so no router-side drivers are needed.

  1. 5G board
  2. Ethernet
  3. Router WAN port
Full compatibility guide

Works with

  • GL.iNet routers

    Beryl AX, Spitz AX, Flint 2 and the rest of the lineup

  • OpenWrt routers

    Any OpenWrt device with an Ethernet WAN port

  • Firewalls & gateways

    OPNsense, pfSense, MikroTik and similar

  • Any other router

    Consumer, ISP and mesh routers with a WAN port

Install in one step

Pick your modem, copy the command, and paste it into your modem's terminal. The installer handles the rest.

One-line installer
v0.1.35
root@OpenWrt:~# curl -sL https://raw.githubusercontent.com/dr-dolomite/QManager/main/qmanager-installer.sh | sh
  1. Run the commandOpen a root shell on your modem (SSH or ADB) and paste the command above.
  2. Let it set upThe installer detects your Qualcomm X55, X62, X65 or X75 modem and configures it for you.
  3. Go onlineOpen 192.168.224.1 in your browser to manage your connection.

Installing offline? Manual installation

Something went wrong? Troubleshooting

Core feature documentation

Highlights from 41 step-by-step guides across 8 categories, covering every part of your Quectel modem.

Browse all 41 guides
Overview

Signal & Cellular Operations

Real-time 4x4 MIMO per-port telemetry, acoustic antenna alignment, and Carrier Aggregation breakdown.

Guides

Live SignalBand LockingTower LockAntenna AlignmentCarrier Aggregation
Overview

Network & Hotspot Settings

Bypass carrier hotspot (tethering) limits with TTL adjustment, IP Passthrough bridge mode, and DPI optimization.

Guides

TTL / MTU EngineIP PassthroughCustom DNSDPI Traffic Engine
Overview

SIM & APN Provisioning

Instant ICCID detection, multi-profile APN mapping, dual-SIM binding, and automatic PDP context management.

Guides

APN ContextsCustom SIM ProfilesKnown SIMsScenario Binding
Overview

Watchdog & Self-Healing

4-tier auto-recovery pipeline: interface reset → radio power toggle → SIM failover → system reboot.

Guides

Watchdog EngineSIM FailoverAdaptive Polling
Overview

Remote Access & Diagnostics

Built-in Tailscale and Netbird mesh VPNs, interactive AT console, and Prometheus metrics scraping.

Guides

Tailscale VPNAT BrokerPrometheus MetricsBackup & Restore
Overview

For Developers

Complete JSON REST API endpoint specifications, baseband serial multiplexing, and a lightweight, zero-overhead backend.

Guides

REST API SpecSystem ArchitectureRM520N Port Ledger

Live web interface preview

Real screenshots captured from running RM520N and RM551E modem dashboards.

http://192.168.224.1/
Live Dashboard screenshot

Live Dashboard

Live 5G/LTE signal strength, serving cell PCI, active band list, and IP allocation.

  • RSRP / RSRQ / SINR gauges
  • Cellular WAN & Gateway state
  • Band lock status indicator
  • Instant connection health

Support the project

QManager is 100% free and open source. If it helped you maximize cellular speeds, simplify your setup, or save time, sending a small tip directly supports hardware testing and continuous releases.

Need a hand?

Bugs go to GitHub, questions go to the Discord community, and anything private goes straight to the maintainer.

Ready to get started?

Set up QManager in under 2 minutes, right on your RM551E, RM520N, or a similar Qualcomm modem.

Not sure which one you have? Check the compatibility list

Pick your modem