Skip to main content
The admin panel is the central management interface for operating the Cloosphere platform. Control all platform settings: user management, organizational structure, LLM connections, security policies, notification channels, and more.
Admin panel main screen

​
Accessing the Admin Panel

Only users with the Admin role can access the admin panel. Regular users (User role) won’t see the admin menu.
Click your user name at the bottom of the sidebar to reveal the Admin Panel menu. Click it to navigate to the admin dashboard.

​
Per-Role Access

Cloosphere has three user roles. Admin panel access is determined by role.
RoleAdmin PanelWorkspaceChat
AdminFull accessFull accessFull access
UserNo access (default)Per group permissionPer group permission
PendingNo accessNo accessNo access
Through group permission settings, you can delegate parts of admin features (user management, monitoring, etc.) to regular users at read or write level. See the group permissions section in User Management.

​
Admin Features

The admin panel consists of these features.

User Management

User list, role assignment, group management, permission settings, inquiry management

Organization Management

Organizational structure, Microsoft Entra ID sync, organization-based access control

System Settings

14 tabs: LLM connections, documents/search/audio/images, interface, license, etc.

Notification Settings

Configure email (SMTP/SendGrid) and webhook (Slack/Teams/Discord/Telegram) notification channels

Code Gateway

LLM API proxy gateway for AI coding tools (Claude Code, Cursor, etc.)

Monitoring

Usage, audit logs, guardrail logs, tracing, evaluations

​
14 System Settings Tabs

System settings classify all configuration needed for platform operations into 14 tabs.
TabDescriptionLink
GeneralAuthentication, default role, log level, usage limitsSettings
ConnectionsOpenAI, Ollama, and other LLM Provider connectionsSettings
ModelsModel list management, default model, model filtersSettings
DocumentsEmbedding engine/model, chunk size, Vector DBSettings
Search EngineAzure Search, Elasticsearch, etc.Settings
Web SearchSearXNG, Google PSE, Bing, and other web search enginesSettings
Code ExecutionCode interpreter (Jupyter/Sandbox) settingsSettings
InterfaceUI customization, default prompts, landing pageSettings
AudioSTT/TTS engine and modelSettings
ImagesImage generation engines (DALL-E, Stable Diffusion)Settings
PipelinesPipeline server connections and managementSettings
ToolsGlobal OpenAPI/MCP tool server settingsSettings
BrandingCustomize logo, favicon, colors, sign-in screenSettings
LicenseLicense key management, feature activationSettings

​
Admin Panel Navigation

The admin panel switches between feature areas via top-tab navigation.

​
Quick Start

1

Configure LLM connections

Register OpenAI API keys or Ollama server URLs in Connections.
2

Manage users

Add users and assign roles in User Management. Create groups for organized permission management.
3

Configure security

Set authentication methods, JWT expiration, and signup permission in General Settings.
4

Set up notification channels

Register email or webhook channels in Notification Settings to enable scheduled task notifications.

​
Service Request (SR)

A feature for admins to directly submit service requests (usage increases, feature inquiries, bug reports, etc.) to the Cloosphere operations team.

​
Activation Conditions

Activated when both the SR_KEY and CLOOCUS_PUBLIC_URL environment variables are set. Without them, the menu doesn’t appear.

​
How to Use

  1. Click your user avatar at the bottom of the sidebar
  2. Pick Service Request from the dropdown
  3. Fill in and submit the SR modal
FieldDescription
TypeRequest type — usage limit, feature request, bug report, account, others
TitleRequest title (brief summary)
ContentRequest details
Requester name and email are auto-attached from sign-in info. SR is shown only to Admin role users.