Ubiquiti · EdgeOS

EdgeRouter CLI Modes, Commit, Save and Commit-Confirm

EdgeOS separates looking at operational state from editing configuration. After an ordinary CLI login, operational mode provides show commands. Enter configuration mode to build changes. The same word, show, has a different purpose there: it displays configuration rather than automatically running an operational status check.

Scope: EdgeRouter running EdgeOS, as documented by the official unversioned CLI-mode article. No numerical release compatibility or lab testing is claimed. Check installed command completion. Not UniFi OS, EdgeSwitch or UISP Router firmware.

Three states matter during a change. The working configuration contains proposed edits. The active configuration controls the running router. The saved boot configuration is loaded after a reboot. Review the difference before applying anything; saving and applying are separate actions.

Mode and action reference #

CommandContextEffect
configureOperationalEnter configuration mode
show configuration commandsOperationalRead configuration as set statements
compareConfigurationReview working-versus-active differences
run show interfacesConfigurationRun an operational inspection
commitConfigurationApply pending edits
saveConfigurationWrite the active configuration for boot
commit-confirm 5ConfigurationApply with a five-minute confirmation deadline
confirmConfigurationCancel the pending confirmation reboot

Inspect first:

Mode and action reference
EdgeOS · Operational CLI

Read-only
show configuration commands | no-more
Output may contain sensitive operational data.
Read-only
show interfaces

For a planned change, enter configuration mode and enter only your approved set/delete statements. Review compare before continuing. The next block applies the pending configuration and starts a reboot deadline; use it only after those edits and the saved recovery baseline have been checked.

Applies configuration — run only after reviewing the pending edits:

Mode and action reference
EdgeOS · Configuration mode

Read-only
compare
Changes configuration
commit-confirm 5

The confirmation deadline reboots into saved configuration. Confirm and save only after validation; see recovery notes below.

Read and answer the router's confirmation prompt. Validate the changed service and open a fresh management connection. If the checks succeed, run:

Mode and action reference
EdgeOS · Configuration mode

Changes configuration
confirm

The confirmation deadline reboots into saved configuration. Confirm and save only after validation; see recovery notes below.

Changes configuration
save

The confirmation deadline reboots into saved configuration. Confirm and save only after validation; see recovery notes below.

Changes configuration
exit

The confirmation deadline reboots into saved configuration. Confirm and save only after validation; see recovery notes below.

Understand the recovery mechanism #

If confirmation does not arrive, EdgeOS reboots and loads the saved boot configuration. This is not an in-place, zero-interruption rollback. Before starting, establish that the saved configuration is the baseline you intend to recover. If there are existing unsaved changes, decide explicitly whether they belong in that baseline; do not blindly save an unknown running state.

Do not save an unvalidated change while relying on reboot-to-saved-configuration as the recovery path. Do not confirm solely because the original SSH session remains connected. An established session can survive a policy change that prevents the next login. Test the path a future administrator will actually use.

A rollback timer cannot repair every fault. A wrong saved baseline, power failure or unrelated hardware problem still needs another recovery path. Choose a confirmation interval long enough for your checks and arrange console or onsite access when losing the site would be costly. Keep the diff and the validation result with the change record so a later reboot does not turn an undocumented edit into a surprise.

Sources

Documentation reviewed: 8 October 2026