Layout
The editor is split into two resizable panels:- Editor panel — A code editor for editing configuration files or viewing historical versions.
- Controls panel — Controls what the editor displays and provides actions like deploying changes or browsing deployment history.
Draft
When the Draft tab is selected in the controls panel, the editor enters edit mode. You can modify any configuration file directly in the editor. Changes are tracked locally until you deploy them. A draft is automatically created when you open the editor. If the device has existing deployments, the draft is based on the most recent one. If this is a new device with no deployments, the draft is initialized from the release’s default configuration.Change list
The controls panel shows a change list that summarizes every modification in the current draft. Changes are grouped by file, with each file section showing its name and a change count (e.g., “3 changes”) or “New file” for newly added files. Within each section, individual changes are listed with:- The type of change — added, modified, or deleted — color-coded green, yellow, or red respectively.
- The JSON path of the affected value (e.g.,
settings > network > ip). Long paths are truncated; hover to see the full path.
Deploying changes
Click the Deploy button to start the deployment process.
The Deploy button is disabled when:
- The device is offline.
- The draft has no changes.
- Any file contains JSON syntax errors.
History
When the History tab is selected, the editor switches to read-only mode and displays past deployments.Deployment list
The controls panel shows all deployments grouped by release version. Within each group, deployments are listed from most recent to oldest with each entry showing:- Description
- Deployment status and ID
- Who created it and when
- Redeploy — Restore an archived deployment (see Redeploy).
- Set as diff base — Use this deployment as the comparison baseline.
- Copy ID or Copy description.
Diff and read-only modes
In the History tab, the editor supports two view modes:- Read-only — Displays the head deployment’s files without any diff highlighting.
- Diff — Highlights the differences between the head and base deployments
using color-coded decorations:
- Green — Added lines.
- Yellow — Modified lines, showing the old and new values.
- Red — Deleted lines, showing the removed content. content.
Diff navigation
When viewing a diff, navigation controls appear as a floating overlay above the footer:- Change navigation — Step through individual changes within the current file using the previous/next buttons. A position label (e.g., “1 of 3”) tracks your place. Open the changes dropdown to see all changes listed by type and JSON path, and jump to any one directly.
- File navigation — When multiple files contain changes, use the file navigation controls to jump between them. A label (e.g., “1 of 3 files”) shows your position.
Base vs. Head
The diff view compares two deployments:- Base — The older deployment used as the comparison starting point. Defaults to the deployment immediately before the head. You can change it using the diff selector in the toolbar or by right-clicking a deployment and selecting “Set as diff base.” Only deployments older than the head are available as a base.
- Head — The currently selected deployment. Shown as a read-only label in the diff selector.
Redeploy
You can redeploy the configurations from any archived deployment. Right-click the deployment in the history list and select Redeploy to open the redeploy dialog. The redeploy dialog shows:- A card with the original deployment’s details (description, status, ID, creator, and date).
- A description field (pre-filled with a reference to the original deployment).
External deployment sync
If another user (or system) deploys to the same device while you have the editor open, an alert appears with the new deployment’s details. The alert offers different options depending on whether you have unsaved edits: No edits in progress:- Acknowledge — Accepts the external deployment and resets your draft to match it.
- Discard — Discards your edits and resets the draft to the external deployment.
- Keep — Merges your edits on top of the external deployment using a three-way JSON merge, preserving your changes where possible.
