Admin Guide

Admin is where operators manage users, providers, alerting, and system audit views.

Users

CH-UI provides two user views:

• Application users: active users and role overrides in CH-UI
• ClickHouse users: live users from selected ClickHouse connection

From Admin you can:

• Create ClickHouse users
• Delete ClickHouse users
• Change ClickHouse user passwords
• Set CH-UI role overrides (admin, analyst, viewer)

Brain Provider Management (Pro)

Configure providers globally for all users:

• Provider kinds: OpenAI-compatible and Ollama-compatible
• Base URL + API key per provider
• Sync models from provider
• Activate/deactivate models in bulk
• Set default provider/model
• Manage global Brain skill instructions

Alerts (Pro)

Alert channels supported:

• SMTP
• Resend
• Brevo

You can configure:

• Channel test recipients
• Alert rules by event/severity
• Multi-route escalation and cooldown
• Event feed for delivery status

Audit And Query Log

Admin exposes:

• Audit log for privileged actions
• Query log snapshot from ClickHouse
• Connection status overview

Operational Commands

./ch-ui server status
./ch-ui server restart
./ch-ui server stop

./ch-ui service status
./ch-ui service restart

Production Notes

• Keep at least one admin override account.
• Rotate provider keys periodically.
• Keep governance sync healthy before relying on policy alerts.