# openwrt/luci architecture

> Architecture diagram of the GitHub repository openwrt/luci, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/openwrt/luci
- Repository: https://github.com/openwrt/luci

## Overview

LuCI is OpenWrt’s web configuration interface. The principal workflow is an administrator using browser-based views to inspect or change router settings, with client-side code communicating through RPC and server-side operations exposing system capabilities. The tree also shows distinct areas for network protocols, status, firewall, package management, and service-specific apps. The README confirms the client API and use of ucode and rpcd for server operations. Source excerpts are limited, so most cross-layer links are shown as unverified rather than asserted calls.

Main entry points: [`libs/rpcd-mod-luci/src/luci.c`](https://github.com/openwrt/luci/blob/master/libs/rpcd-mod-luci/src/luci.c) (rpcd operations), [`applications`](https://github.com/openwrt/luci/tree/master/applications) (LuCI app views), [`modules/luci-mod-dashboard/htdocs/luci-static/resources/view/dashboard/include/10_router.js`](https://github.com/openwrt/luci/blob/master/modules/luci-mod-dashboard/htdocs/luci-static/resources/view/dashboard/include/10_router.js) (Dashboard), [`modules/luci-mod-status/htdocs/luci-static/resources/view/status`](https://github.com/openwrt/luci/tree/master/modules/luci-mod-status/htdocs/luci-static/resources/view/status) (System status)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Web interface"]
  node_views["LuCI app views"]
  node_dashboard["Dashboard<br/>[10_router.js]"]
  node_status["System status"]
  node_storage["Storage view<br/>[25_storage.js]"]
end

subgraph group_network["Network configuration"]
  node_network_views["Network views"]
  node_protocols["Network protocols"]
  node_firewall["Firewall management"]
end

subgraph group_services["Service apps"]
  node_service_apps["Service configuration"]
  node_package_manager["Package manager<br/>[package-manager.js]"]
  node_file_manager["File manager<br/>[filemanager.js]"]
end

subgraph group_runtime["Runtime and RPC"]
  node_browser_api["Client APIs"]
  node_rpcd["rpcd operations<br/>[luci.c]"]
  node_rrdns["Reverse DNS RPC<br/>[rrdns.c]"]
  node_lua_templates["Lua templates<br/>[template_parser.c]"]
  node_template_utils["Template utilities<br/>[template_utils.h]"]
  node_nixio_tls["TLS support<br/>[tls-context.c]"]
end

node_admin(("Administrator"))
node_router["OpenWrt system"]

node_admin -.->|"configures"| node_views
node_admin -.->|"views"| node_dashboard
node_views -.->|"uses client APIs"| node_browser_api
node_dashboard -.->|"summarizes"| node_status
node_status -.->|"includes"| node_storage
node_network_views -.->|"configures"| node_protocols
node_admin -.->|"configures"| node_network_views
node_admin -.->|"configures"| node_firewall
node_admin -.->|"configures"| node_service_apps
node_admin -.->|"manages packages"| node_package_manager
node_admin -.->|"manages files"| node_file_manager
node_browser_api -.->|"invokes server operations"| node_rpcd
node_rpcd -.->|"operates on"| node_router
node_rrdns -.->|"resolves addresses"| node_router
node_lua_templates -->|"uses utilities"| node_template_utils
node_rpcd -.->|"registers RPC"| node_rrdns

click node_views "https://github.com/openwrt/luci/tree/master/applications"
click node_dashboard "https://github.com/openwrt/luci/blob/master/modules/luci-mod-dashboard/htdocs/luci-static/resources/view/dashboard/include/10_router.js"
click node_status "https://github.com/openwrt/luci/tree/master/modules/luci-mod-status/htdocs/luci-static/resources/view/status"
click node_storage "https://github.com/openwrt/luci/blob/master/modules/luci-mod-status/htdocs/luci-static/resources/view/status/include/25_storage.js"
click node_network_views "https://github.com/openwrt/luci/tree/master/modules/luci-mod-network/htdocs/luci-static/resources/view/network"
click node_protocols "https://github.com/openwrt/luci/tree/master/protocols"
click node_firewall "https://github.com/openwrt/luci/tree/master/applications/luci-app-firewall/htdocs/luci-static/resources/view/firewall"
click node_service_apps "https://github.com/openwrt/luci/tree/master/applications"
click node_package_manager "https://github.com/openwrt/luci/blob/master/applications/luci-app-package-manager/htdocs/luci-static/resources/view/package-manager.js"
click node_file_manager "https://github.com/openwrt/luci/blob/master/applications/luci-app-filemanager/htdocs/luci-static/resources/view/system/filemanager.js"
click node_browser_api "https://github.com/openwrt/luci/tree/master/modules/luci-base/htdocs/luci-static/resources"
click node_rpcd "https://github.com/openwrt/luci/blob/master/libs/rpcd-mod-luci/src/luci.c"
click node_rrdns "https://github.com/openwrt/luci/blob/master/libs/rpcd-mod-rrdns/src/rrdns.c"
click node_lua_templates "https://github.com/openwrt/luci/blob/master/modules/luci-lua-runtime/src/template_parser.c"
click node_template_utils "https://github.com/openwrt/luci/blob/master/modules/luci-lua-runtime/src/template_utils.h"
click node_nixio_tls "https://github.com/openwrt/luci/blob/master/libs/luci-lib-nixio/src/tls-context.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_views,node_dashboard,node_status,node_storage toneBlue
class node_network_views,node_protocols,node_firewall toneAmber
class node_service_apps,node_package_manager,node_file_manager toneMint
class node_browser_api,node_rpcd,node_rrdns,node_lua_templates,node_template_utils,node_nixio_tls toneRose
class node_admin,node_router toneIndigo
```

## Components

### Web interface

- [LuCI app views](https://github.com/openwrt/luci/tree/master/applications): `applications`
- [Dashboard](https://github.com/openwrt/luci/blob/master/modules/luci-mod-dashboard/htdocs/luci-static/resources/view/dashboard/include/10_router.js): `modules/luci-mod-dashboard/htdocs/luci-static/resources/view/dashboard/include/10_router.js`
- [System status](https://github.com/openwrt/luci/tree/master/modules/luci-mod-status/htdocs/luci-static/resources/view/status): `modules/luci-mod-status/htdocs/luci-static/resources/view/status`
- [Storage view](https://github.com/openwrt/luci/blob/master/modules/luci-mod-status/htdocs/luci-static/resources/view/status/include/25_storage.js): `modules/luci-mod-status/htdocs/luci-static/resources/view/status/include/25_storage.js`

### Network configuration

- [Network views](https://github.com/openwrt/luci/tree/master/modules/luci-mod-network/htdocs/luci-static/resources/view/network): `modules/luci-mod-network/htdocs/luci-static/resources/view/network`
- [Network protocols](https://github.com/openwrt/luci/tree/master/protocols): `protocols`
- [Firewall management](https://github.com/openwrt/luci/tree/master/applications/luci-app-firewall/htdocs/luci-static/resources/view/firewall): `applications/luci-app-firewall/htdocs/luci-static/resources/view/firewall`

### Service apps

- [Service configuration](https://github.com/openwrt/luci/tree/master/applications): `applications`
- [Package manager](https://github.com/openwrt/luci/blob/master/applications/luci-app-package-manager/htdocs/luci-static/resources/view/package-manager.js): `applications/luci-app-package-manager/htdocs/luci-static/resources/view/package-manager.js`
- [File manager](https://github.com/openwrt/luci/blob/master/applications/luci-app-filemanager/htdocs/luci-static/resources/view/system/filemanager.js): `applications/luci-app-filemanager/htdocs/luci-static/resources/view/system/filemanager.js`

### Runtime and RPC

- [Client APIs](https://github.com/openwrt/luci/tree/master/modules/luci-base/htdocs/luci-static/resources): `modules/luci-base/htdocs/luci-static/resources`
- [rpcd operations](https://github.com/openwrt/luci/blob/master/libs/rpcd-mod-luci/src/luci.c): `libs/rpcd-mod-luci/src/luci.c`
- [Reverse DNS RPC](https://github.com/openwrt/luci/blob/master/libs/rpcd-mod-rrdns/src/rrdns.c): `libs/rpcd-mod-rrdns/src/rrdns.c`
- [Lua templates](https://github.com/openwrt/luci/blob/master/modules/luci-lua-runtime/src/template_parser.c): `modules/luci-lua-runtime/src/template_parser.c`
- [Template utilities](https://github.com/openwrt/luci/blob/master/modules/luci-lua-runtime/src/template_utils.h): `modules/luci-lua-runtime/src/template_utils.h`
- [TLS support](https://github.com/openwrt/luci/blob/master/libs/luci-lib-nixio/src/tls-context.c): `libs/luci-lib-nixio/src/tls-context.c`

### Other components

- **Administrator**
- **OpenWrt system**

## Connections

- Administrator → LuCI app views: configures
- Administrator → Dashboard: views
- LuCI app views → Client APIs: uses client APIs
- Dashboard → System status: summarizes
- System status → Storage view: includes
- Network views → Network protocols: configures
- Administrator → Network views: configures
- Administrator → Firewall management: configures
- Administrator → Service configuration: configures
- Administrator → Package manager: manages packages
- Administrator → File manager: manages files
- Client APIs → rpcd operations: invokes server operations (evidence: `README.md`)
- rpcd operations → OpenWrt system: operates on (evidence: `README.md`)
- Reverse DNS RPC → OpenWrt system: resolves addresses (evidence: `libs/rpcd-mod-rrdns/src/rrdns.c`)
- Lua templates → Template utilities: uses utilities (evidence: `modules/luci-lua-runtime/src/template_parser.c`)
- rpcd operations → Reverse DNS RPC: registers RPC
