Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Note: This page applies almost equally to the legacy GUI and its replacement GUI2. Any new enhancements are added to GUI2 only. See GUI Release Notes for details of new features

GUI Overview

The ONOS GUI is a single-page web-application, providing a visual interface to the ONOS controller (or cluster of controllers).

For documentation on how applications running on ONOS can inject content to the GUI at runtime, see (TBD)see the Web UI tutorials.

For documentation on the design of the GUI, see the GUI Architecture pagesee Web UI Architecture in the Architecture Guide.

GUI Configuration Notes

  • The onos-gui feature must be installed in ONOS.
  • The GUI listens on port 8181.
  • The base URL is /onos/ui; for example, to access the GUI on localhost, use: http://localhost:8181/onos/ui
  • The GUI has been developed to work on Google Chrome. Other The GUI has been tested on Safari and Firefox and minor compatibility adjustments have been made; these and other browsers may work, but have not been extensively tested, and are not actively supported, at this time.
  • The key bindings associated with any view will work on any keyboard. The "Cmd" (⌘) key on an Apple keyboard is bound to the same key as the "Windows" or "Alt" keys on Windows or other keyboards.

GUI Session Notes

Note that the current version of the GUI does not fully support the concept of users, nor require login credentials. These enhancements will be added in a later releaseindividual user accounts, however, login credentials are required.

On launching the GUI you should see a screen that looks the login screen: 

Image Added

Default username and password are onos/rocks.

If ONOS was installed via onos-install and configured by onos-secure-ssh (developer/test tools), then the passwords may be different; examine the $ONOS_WEB_USER and $ONOS_WEB_PASS environment variables.

After a successful login, you should see a screen that looks something like this:

Image RemovedImage Added

The dark gray bar at the top is the Masthead, which provides a location for general GUI controls. In the current version (1.1.0 "Blackbird") this is where the "topology layer filter" radio buttons are placed.  Items shown with red text / arrows are always present:

  • the Navigation Menu button
  • the ONOS logo and title
  • the Context Help button (click to open web URL specific to current view)
  • the User Name (click to access logout link)

 (In future versions, this will be where session controls – user ID, user preferences, logout etc. -- will be locatedthe masthead may include session controls such as user preferences, global search, etc.)

The remainder of the screen is the "view" – in this case the "Topology View" which gives a , which defaults to the Topology View when the GUI is first loaded (items shown with purple text / arrows) – a cluster-wide view of the network topology.The

  • The ONOS


  • Cluster Node Panel


  •  indicates the cluster members (controller instances) in the cluster.


  • The Summary Panel


  •  gives a brief summary of properties of the network topology.
  • The Topology Toolbar (initially hidden) provides push-button / toggle-button actions that interact with the topology view.

For more detailed information about this view, see the Topology View page.

GUI Navigation


Other views can be "navigated to" by clicking on the Navigation Menu Button in the masthead, then selecting an item from the dropdown menu:

Image Added

GUI Views

The GUI is capable of supporting multiple views, although this feature has not yet been fully developed. As new views are added to the base release, they will be documented here.


The capability of adding views to the GUI dynamically at run-time is also being developed. This will allowavailable to developers, allowing, for example, an ONOS App developer to create GUI content that works specifically with his their application. The content will be injected dynamically injected into  into the GUI when the app is installed, and automatically removed automatically from the GUI when the app is uninstalled. For more details on this feature, see (TBD).

Topology View


 see the Web UI tutorials.

The views currently included in the base release are:

Platform Category
ApplicationsThe Application View* provides a listing of applications installed, as well as interaction with them on the network.
SettingsThe Settings View* provides information about all configurable settings in the system.
Cluster NodesThe Cluster Node View* provides a top level listing of all the cluster nodes, (ONOS instances), in the network.
Packet ProcessorsThe Packet Processors View* shows the currently configured components that participate in the processing of packets sent to the controller.
PartitionsThe Partitions View* shows information about how the cluster partitions are configured.
Network Category
TopologyThe Topology View provides an interactive visualization of the network topology, including an indication of which devices (switches) are mastered by each ONOS controller instance.


Device View


Topology 2The Topology 2 View (currently experimental) is an alternative to the Topology View, providing the ability to view the network in a more hierarchical manner.
DevicesThe Device View* provides a top level listing of the devices in the network.




Flow View* provides a


Release Notes

This section provides a reverse-chronological listing of changes to the GUI for each release.

Blackbird – 1.1.0


  • View-agnostic features refactored as Angular Services.


  • Topology source code broken out into multiple source files.
  • Port Highlighting on links added.


  • Implemented as a simple table for now; one device per row, sortable by column header clicks.


  • Skeletal example code.


  • Press the 'T' key to toggle theme.


  • By default, the Avocet GUI is launched; the base URL http://localhost:8181/onos/ui is mapped to http://localhost:8181/onos/ui/legacy/index.html#topo.
  • The new Angular-based GUI can be launched by manually adjusting the URL to be:  http://localhost:8181/onos/ui/index.html#topo, (that is, remove "legacy/"). 

Avocet – 1.0.0

  • GUI implemented using a home-grown framework. 
  • Single view (Topology View) implemented, displaying network topology and providing a certain level of interaction to show traffic & flow information.
  • Although the 'T' key-binding (toggle theme) is present, the "dark" theme has not been implemented.








top level listing of all flows for a selected device. (Note that this view is not on the navigation menu.)
**PortsThe Port View* provides a top level listing of all ports for a selected device. (Note that this view is not on the navigation menu.)
**GroupsThe Group View* provides a top level listing of all groups for a selected device. (Note that this view is not on the navigation menu.)
**MetersThe Meter View* provides a top level listing of all meters for a selected device. (Note that this view is not on the navigation menu.)
LinksThe Link View* provides a top level listing of all the links in the network.
HostsThe Host View* provides a top level listing of all the hosts in the network.
IntentsThe Intent View* provides a top level listing of all the intents in the network.
TunnelsThe Tunnel View* provides a top level listing of all tunnels defined in the network.

*Tabular Views: The GUI has multiple "tabular views" that are similar in look and interaction, but display different information. For a general overview of tabular usage, see the Tabular View page. For specifics on each view, follow the links in the above table.

**Hidden Views: Some views (e.g. flows, ports, groups, meters) do not show up on the Navigation Menu, but are navigable from other views (e.g. the device view).

Web UI Applications

ONOS applications may contain Web UI components – either custom views, or topology overlay behaviors. For documentation on application-specific behavior, please see the Web UI Application Index.

Release Notes

See the reverse-chronological summary of changes to the GUI for each release.


Previous : The ONOS CLI
Next : Distributed ONOS