apache/skywalking-ui repository overview

⁠Apache SkyWalking UI

These Docker images are not official ASF releases but are provided for convenience. The recommended usage is always to build from source.

This repository hosts two UIs for Apache SkyWalking⁠:

• Booster UI — the current production UI. Tags: 9.x / 10.x.
• Horizon UI — the next-generation UI. Tags: horizon-X.Y.Z and latest.

⁠Horizon UI

A modernized, dense, dark-first web UI on the same OAP GraphQL query-protocol and MQE. One image bundles the backend-for-frontend and the built UI — no separate frontend container. Multi-arch: linux/amd64 + linux/arm64.

⁠Features

• Per-layer dashboards, service/instance/endpoint drill-down, topology, traces, logs, profiling, alarms.
• Template-driven dashboards with an in-UI editor (edit locally, then publish to OAP).
• MQE editor with syntax highlighting and debugging.
• Built-in auth + RBAC (roles → verbs), audit log, and OAP platform views (cluster, inspect, data retention, configuration).

⁠How to use

# 1. Get the example config to start from
docker run --rm apache/skywalking-ui:latest \
  cat /app/horizon.example.yaml > horizon.yaml

# 2. Edit horizon.yaml (OAP endpoint + auth — see below)

# 3. Run
docker run -d --name horizon-ui -p 8081:8081 \
  -v "$(pwd)/horizon.yaml:/app/horizon.yaml:ro" \
  -v horizon-data:/data \
  apache/skywalking-ui:latest

Open http://localhost:8081⁠. Pin horizon-X.Y.Z (not latest) for production.

⁠OAP setup

Point Horizon at your OAP's query + admin endpoints in horizon.yaml:

oap:
  queryUrl: http://<oap-host>:12800   # GraphQL query-protocol
  adminUrl: http://<oap-host>:12800   # admin / debugging REST surface

⁠Authentication

Two backends, selected by auth.backend:

• local — static users defined in horizon.yaml (auth.local.users), each with an Argon2 password hash and a role list. Simplest for small teams.
• ldap — bind against your directory (auth.ldap); group DNs map to roles via auth.ldap.groupMappings.

Either way, roles resolve to RBAC verbs that gate every page and API.

⁠Documentation

Full configuration, dashboards, RBAC, and operations guides: https://skywalking.apache.org/⁠ · source: https://github.com/apache/skywalking-horizon-ui⁠

Licensed under the Apache License 2.0.