General User Interface¶
This article explains the basics of the OPNsense Graphical User Interface or GUI for short.
Before we can take a look at the GUI options we need to login. The default user is root and the password is opnsense.
GUI Layout & Main Components¶
The GUI consists out of the following main components:
User & Local domain¶
In the right corner just to the left of the quick navigation you will see your username and the full domain name the firewall is configured with (to change firewall name, go to).
The content area is used to display:
General forms of data output graphical and text based
Let’s take a look at how an advanced form may look like:
Many forms are equipped with built-in help. In the upper right corner of the form you can select to view all help messages at once. The toggle will color green when enabled and show the help messages beneath the input items.
Some forms have hidden advanced features, to view them toggle the advanced mode in the left corner of the form. Doing so will reveal all advanced options.
Single Item Help¶
Show a single line help by pressing the (i) left of a form item. Like this:
A standard tab can be clicked upon to open the corresponding form.
A sample can be seen here:
A dropdown tab can be clicked upon to open the first menu item or you can click on the arrow next to it to show all options, like so:
Many components within OPNsense use grid views to navigate through content, below is an example of a simple table view supporting the most relevant actions.
Fields¶The available fields vary between components, the icon can be used to select which fields should be visible or hidden.
Filter and limit¶The top area of the grid contains a search input combined with a reload button and a selection for the number of rows to show at once on a page. Often the search input will be instantly applied, but in some cases a reload is needed if the action can't be processed fast enough.
Actions¶Different actions could be supported on a (set of) records:
- / Enable / disable a record
- Edit a record
- Copy a record and edit
- Delete a record, usually this will ask for a confirmation
- Add a new record and open edit dialog