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.

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

ActionWindows/LinuxmacOS
Open Command PaletteF1F1

Basic Editing

ActionWindows/LinuxmacOS
Cut lineCtrl+XCmd+X
Copy lineCtrl+CCmd+C
PasteCtrl+VCmd+V
UndoCtrl+ZCmd+Z
RedoCtrl+YCmd+Shift+Z
Delete lineCtrl+Shift+KCmd+Shift+K
Insert line belowCtrl+EnterCmd+Enter
Insert line aboveCtrl+Shift+EnterCmd+Shift+Enter
Move line downAlt+DownOption+Down
Move line upAlt+UpOption+Up
Copy line downShift+Alt+DownShift+Option+Down
Copy line upShift+Alt+UpShift+Option+Up

Selection

ActionWindows/LinuxmacOS
Select allCtrl+ACmd+A
Expand selectionShift+Alt+RightCtrl+Shift+Cmd+Right
Shrink selectionShift+Alt+LeftCtrl+Shift+Cmd+Left
Add selection to next find matchCtrl+DCmd+D
Select all occurrences of find matchCtrl+Shift+LCmd+Shift+L
Change all occurrencesCtrl+F2Cmd+F2
Add cursor aboveCtrl+Alt+UpCmd+Option+Up
Add cursor belowCtrl+Alt+DownCmd+Option+Down
Add cursors to line endsShift+Alt+IShift+Option+I
Column (box) selectionShift+Alt+DragShift+Option+Drag

Find and Replace

ActionWindows/LinuxmacOS
FindCtrl+FCmd+F
ReplaceCtrl+HCmd+Option+F
Find nextF3Cmd+G
Find previousShift+F3Cmd+Shift+G
Find next selectionCtrl+F3Cmd+E
Toggle find regexAlt+RCmd+Option+R
Toggle case sensitiveAlt+CCmd+Option+C
Toggle whole wordAlt+WCmd+Option+W
ActionWindows/LinuxmacOS
Go to lineCtrl+GCtrl+G
Go to matching bracketCtrl+Shift+\Cmd+Shift+\
Go to start of fileCtrl+HomeCmd+Up
Go to end of fileCtrl+EndCmd+Down
Go to start of lineHomeCmd+Left
Go to end of lineEndCmd+Right

Code Folding

ActionWindows/LinuxmacOS
Fold regionCtrl+Shift+[Cmd+Option+[
Unfold regionCtrl+Shift+]Cmd+Option+]
Fold all regionsCtrl+K Ctrl+0Cmd+K Cmd+0
Unfold all regionsCtrl+K Ctrl+JCmd+K Cmd+J
Fold recursivelyCtrl+K Ctrl+[Cmd+K Cmd+[
Unfold recursivelyCtrl+K Ctrl+]Cmd+K Cmd+]
Toggle foldCtrl+K Ctrl+LCmd+K Cmd+L

Comments

ActionWindows/LinuxmacOS
Toggle line commentCtrl+/Cmd+/

Indentation

ActionWindows/LinuxmacOS
Indent lineCtrl+]Cmd+]
Outdent lineCtrl+[Cmd+[

IntelliSense and Hints

ActionWindows/LinuxmacOS
Trigger suggestCtrl+SpaceCtrl+Space
Show hoverCtrl+K Ctrl+ICmd+K Cmd+I

Display

ActionWindows/LinuxmacOS
Toggle word wrapAlt+ZOption+Z
Zoom inCtrl++Cmd++
Zoom outCtrl+-Cmd+-
Reset zoomCtrl+0Cmd+0

Multi-Cursor Editing Tips

The configuration editor supports powerful multi-cursor editing:

  1. Add cursors with keyboard: Use Ctrl+Alt+Up/Down (Cmd+Option+Up/Down on macOS) to add cursors above or below the current position.

  2. Add cursors by selection: Select a word and press Ctrl+D (Cmd+D) to select the next occurrence. Repeat to select more occurrences.

  3. Select all occurrences: Press Ctrl+Shift+L (Cmd+Shift+L) to select all occurrences of the current selection at once.

  4. 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.