DocsSettings
Configure appearance, email, API keys, and advanced platform options.
The Settings page lets you configure your Kaelio instance across eight sections accessible from a sidebar, covering everything from branding and AI behavior to API keys and system maintenance.
Appearance
This section controls your instance's visual identity, including logos, colors, and typography.
- Logo — Upload a logo image displayed in the navigation bar
- Mascot — Upload a mascot image used in the AI chat interface
- Brand Colors — Set primary, secondary, and tertiary colors using a color picker
- Typography — Choose a font family from the dropdown or
upload custom fonts (
.ttfor.otffiles)
Click Save Changes to apply your updates.
General
This section controls AI behavior, scheduling, and dashboard settings.
AI agent
These settings determine how the AI handles research, visibility, and parallel execution.
| Setting | Description |
|---|---|
| Research Mode | Controls how thoroughly the AI researches before answering: Direct, Balanced, or Exploratory |
| Simple Mode | When enabled, hides technical details (SQL, execution plans) from non-admin users |
| User-Scoped Knowledge | When enabled, each user builds their own knowledge context; when disabled, knowledge is shared globally |
| SQL Batch Size | Maximum number of SQL queries the AI can run in parallel |
Scheduler
These settings control automated task scheduling.
- Enable Scheduler — Toggle automatic scheduled tasks on or off
- Execution Interval — Time between scheduler runs (in seconds)
Dashboard
These settings govern how dashboard widgets refresh.
- Widget Refresh Concurrency — Number of dashboard widgets that refresh simultaneously
- Widget Refresh Timeout — Maximum time (in seconds) for a widget refresh to complete
AI analysis limits
These limits control how much text the AI processes when analyzing schema metadata.
- Datasource Max Words — Word limit for data source descriptions
- Table Max Words — Word limit for table descriptions
- Column Max Words — Word limit for column descriptions
This section shows your current email configuration and lets you verify it works.
The page displays the current SMTP status:
- From address
- SMTP server and port
- Whether authentication is enabled
Click Send Test Email to verify the configuration. A success or failure notification appears after the test.
Email configuration is typically set through environment variables. The Settings page shows the current status but may not allow editing depending on your deployment.
Maintenance
This section provides tools for system maintenance and debugging.
Server logs
Expand the log viewer to browse recent server logs. Use the
Copy button to copy logs to your clipboard, or click
Download All Logs to save a .zip archive.
Chat export
Export all chat messages to CSV or JSON format for analysis or backup.
Agent tools tester
This interface lets you verify AI agent tool configurations directly from the admin panel.
API keys
This section lets you create API keys for programmatic access to Kaelio's capabilities.
Creating a key
Click Create API Key.
Enter a name and optionally set an expiration date.
Click Create Key. The full API key is displayed once — copy it immediately.
The API key is only shown once when created. If you lose it,
you must create a new key. Use the key in the X-API-Key
header for API requests.
The API Keys table shows all keys with their name, key prefix, creation date, last-used date, and expiration status. Delete keys you no longer need.
Advanced
This section provides a JSON editor for viewing and modifying raw platform configuration. Use it for settings not exposed through other sections.
The Advanced editor modifies platform configuration directly. Incorrect values can affect platform behavior. Only change settings you understand.
Jobs
This section lets you run background processing tasks.
Knowledge backfill
Process historical chat messages to extract knowledge blocks.
Select a date range for the messages to process.
Click Search to preview how many messages will be processed and how many have already been handled.
Click Start Backfill to begin processing. A progress indicator tracks the job.
Misc
This section displays read-only server details and embedding controls.
Server information
Displays read-only information about your Kaelio server: IP address, location, organization, and timezone.
Embeddings
Shows the active embedding provider. Click Refresh All Embeddings to regenerate vector embeddings for all content. This is useful after changing the embedding provider or if search quality has degraded.