Configuration Editor
Features and keyboard shortcuts for the Management UI configuration editor
The Management UI provides a complete configuration editing experience with file management, syntax highlighting, auto-completion, validation, and change management.
Navigating Configuration Files
Access configuration files in the Management UI by navigating to Configuration -> Files. This view displays the contents of the Radiator working directory (/var/lib/radiator), including:
- Configuration files (
.radconf) - Supporting directories:
db/,tls/,lua/,templates/, and others
Click a file to open it in the editor. Click a directory to navigate into it. Use the breadcrumb navigation at the top to move between directories.
File Operations
The Create button provides options to:
- Create a new configuration file from a template
- Create an empty configuration file
- Create a new directory
- Upload a file
The menu button (...) provides bulk operations:
- Import a configuration archive (
.zip) - Export the current configuration as a ZIP archive
For detailed information about import and export functionality, see Configuration Import and Export.
Editing Configuration Files
Click a file to open it in the configuration editor.
Radiator-Specific Features
The configuration editor includes enhancements tailored for Radiator configuration:
- Auto-completion: Press Ctrl+Space (Ctrl+Space on macOS) to trigger suggestions for configuration statements, blocks, and values.
- Hover documentation: Hover over configuration keywords to see documentation. Click links in the hover popup to open the reference manual.
- Syntax highlighting: Configuration files use custom syntax highlighting optimized for the Radiator configuration language.
- Error markers: Syntax and validation errors are highlighted with red underlines. Hover over errors to see details.
Keyboard Shortcuts
Press F1 to open the command palette and search for any command by name.
Command Palette
| Action | Windows/Linux | macOS |
|---|---|---|
| Open Command Palette | F1 | F1 |
Basic Editing
| Action | Windows/Linux | macOS |
|---|---|---|
| Cut line | Ctrl+X | Cmd+X |
| Copy line | Ctrl+C | Cmd+C |
| Paste | Ctrl+V | Cmd+V |
| Undo | Ctrl+Z | Cmd+Z |
| Redo | Ctrl+Y | Cmd+Shift+Z |
| Delete line | Ctrl+Shift+K | Cmd+Shift+K |
| Insert line below | Ctrl+Enter | Cmd+Enter |
| Insert line above | Ctrl+Shift+Enter | Cmd+Shift+Enter |
| Move line down | Alt+Down | Option+Down |
| Move line up | Alt+Up | Option+Up |
| Copy line down | Shift+Alt+Down | Shift+Option+Down |
| Copy line up | Shift+Alt+Up | Shift+Option+Up |
Selection
| Action | Windows/Linux | macOS |
|---|---|---|
| Select all | Ctrl+A | Cmd+A |
| Expand selection | Shift+Alt+Right | Ctrl+Shift+Cmd+Right |
| Shrink selection | Shift+Alt+Left | Ctrl+Shift+Cmd+Left |
| Add selection to next find match | Ctrl+D | Cmd+D |
| Select all occurrences of find match | Ctrl+Shift+L | Cmd+Shift+L |
| Change all occurrences | Ctrl+F2 | Cmd+F2 |
| Add cursor above | Ctrl+Alt+Up | Cmd+Option+Up |
| Add cursor below | Ctrl+Alt+Down | Cmd+Option+Down |
| Add cursors to line ends | Shift+Alt+I | Shift+Option+I |
| Column (box) selection | Shift+Alt+Drag | Shift+Option+Drag |
Find and Replace
| Action | Windows/Linux | macOS |
|---|---|---|
| Find | Ctrl+F | Cmd+F |
| Replace | Ctrl+H | Cmd+Option+F |
| Find next | F3 | Cmd+G |
| Find previous | Shift+F3 | Cmd+Shift+G |
| Find next selection | Ctrl+F3 | Cmd+E |
| Toggle find regex | Alt+R | Cmd+Option+R |
| Toggle case sensitive | Alt+C | Cmd+Option+C |
| Toggle whole word | Alt+W | Cmd+Option+W |
Navigation
| Action | Windows/Linux | macOS |
|---|---|---|
| Go to line | Ctrl+G | Ctrl+G |
| Go to matching bracket | Ctrl+Shift+\ | Cmd+Shift+\ |
| Go to start of file | Ctrl+Home | Cmd+Up |
| Go to end of file | Ctrl+End | Cmd+Down |
| Go to start of line | Home | Cmd+Left |
| Go to end of line | End | Cmd+Right |
Code Folding
| Action | Windows/Linux | macOS |
|---|---|---|
| Fold region | Ctrl+Shift+[ | Cmd+Option+[ |
| Unfold region | Ctrl+Shift+] | Cmd+Option+] |
| Fold all regions | Ctrl+K Ctrl+0 | Cmd+K Cmd+0 |
| Unfold all regions | Ctrl+K Ctrl+J | Cmd+K Cmd+J |
| Fold recursively | Ctrl+K Ctrl+[ | Cmd+K Cmd+[ |
| Unfold recursively | Ctrl+K Ctrl+] | Cmd+K Cmd+] |
| Toggle fold | Ctrl+K Ctrl+L | Cmd+K Cmd+L |
Comments
| Action | Windows/Linux | macOS |
|---|---|---|
| Toggle line comment | Ctrl+/ | Cmd+/ |
Indentation
| Action | Windows/Linux | macOS |
|---|---|---|
| Indent line | Ctrl+] | Cmd+] |
| Outdent line | Ctrl+[ | Cmd+[ |
IntelliSense and Hints
| Action | Windows/Linux | macOS |
|---|---|---|
| Trigger suggest | Ctrl+Space | Ctrl+Space |
| Show hover | Ctrl+K Ctrl+I | Cmd+K Cmd+I |
Display
| Action | Windows/Linux | macOS |
|---|---|---|
| Toggle word wrap | Alt+Z | Option+Z |
| Zoom in | Ctrl++ | Cmd++ |
| Zoom out | Ctrl+- | Cmd+- |
| Reset zoom | Ctrl+0 | Cmd+0 |
Multi-Cursor Editing Tips
The configuration editor supports powerful multi-cursor editing:
-
Add cursors with keyboard: Use Ctrl+Alt+Up/Down (Cmd+Option+Up/Down on macOS) to add cursors above or below the current position.
-
Add cursors by selection: Select a word and press Ctrl+D (Cmd+D) to select the next occurrence. Repeat to select more occurrences.
-
Select all occurrences: Press Ctrl+Shift+L (Cmd+Shift+L) to select all occurrences of the current selection at once.
-
Column selection: Hold Shift+Alt (Shift+Option on macOS) and drag to create a rectangular selection with a cursor on each line.
Configuration Validation
The editor provides two levels of configuration validation:
Syntax Check
Syntax check validates the structure and syntax of the current file without loading external files or starting the server. Use this for quick validation during editing.
In the file editor, click Check and select Syntax check to validate the current file. Syntax check is also performed automatically in the background when auto-check is enabled.
Full Check
Full check performs a complete validation by loading all configuration files (following include and include_glob statements) and attempting to start the server in dry-run mode. This does not stop or restart the server itself.
This catches semantic errors such as:
- Missing referenced files
- Invalid backend configurations
- Port conflicts
- Certificate issues
In the file editor, click Check and select Full check to run a complete validation. In the files list view, use the Review button to access the full check before deploying changes.
Validation Results
When validation fails, errors appear in an alert below the editor. Each error shows:
- The file path (clickable to open the file)
- The line number (if available)
- The error message
- Additional context or causes
Pending Configuration and Change Management
Changes made in the configuration editor are saved to a pending configuration directory rather than directly modifying the active configuration. This allows reviewing and testing changes before deployment.
Pending Changes Indicator
When pending changes exist, an alert appears at the top of the files view showing:
- The number of changed files
- When the pending configuration was created
- Review and Restore from Backup buttons
Review View
Click Review to open the change management dialog. This view shows:
- A list of all changed files with their change type (new, modified, or deleted)
- Test buttons to validate the pending configuration
- Deploy options
Deploying Changes
Before deploying, use Test Syntax or Test Full to validate the pending configuration. Test Full is recommended as it catches semantic errors.
The deploy dialog provides options:
- Create backup before deploying (enabled by default) - Creates a backup of the current active configuration before replacing it with the pending changes
- Auto-restart server after deployment - Automatically restarts the server to apply the new configuration
Click Deploy to apply the pending changes to the active configuration.
Restore from Backup
Click Restore from Backup to restore a previous configuration. Backups are created automatically when deploying with the backup option enabled.
Restoring a backup copies it into the pending configuration. Review the restored configuration and deploy when ready.
Discard Changes
Click Discard to permanently delete all pending changes and revert to the active configuration.
Restoring Individual Files
To restore a single file to its active configuration version:
- In the Review dialog, click the restore icon next to a changed file
- In the files list, click the menu button (...) next to a file that has pending changes and select Restore
This is useful for undoing changes to individual files without discarding all pending changes.
Architecture Overview
Backend Load Balancing
Basic Installation
Comparison Operators
Configuration Editor
Configuration Import and Export
Data Types
Duration Units
Execution Context
Execution Pipelines
Filters
Health check /live and /ready
High Availability and Load Balancing
High availability identifiers
HTTP Basic Authentication
Introduction
Local AAA Backends
Log storage and formatting
Management API privilege levels
Namespaces
Password Hashing
Pipeline Directives
Probabilistic Sampling
Prometheus scraping
PROXY Protocol Support
Radiator server health and boot up logic
Radiator sizing
Radiator software releases
Rate Limiting
Rate Limiting Algorithms
Reverse Dynamic Authorization
Template Rendering CLI
Tools radiator-client
TOTP/HOTP Authentication
What is Radiator?