Page tree

Versions Compared


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


This page is out of date and applied to releases before 1.14 - for up to date instructions see Using an IDE with ONOS 1.14 or higher (Bazel build)

The Youtube Video has been removed


In this screencast we will show you how easy it is to import ONOS code into the IntelliJ IDE. This demonstration assumes that the ONOS code has already been checked out and preferably also built using the onos-build command.

Importing the project

To import the ONOS project, simply open IntelliJ IDEA and select: File… New… Project from Existing Sources


At this point IntelliJ will complete the import process by building the project and indexing the source files.

Importing the settings

While the project is being processed, we can go ahead and import the recommended IDEA settings. We do this by selecting File… Import Settings… and then navigating to the ONOS tools/dev directory and selecting the idea-settings.jar file. We can complete the process by pressing the OK button.

Importing the Copyright header

Since ONOS is licensed under Apache 2 license, we need to make sure that all source files are properly decorated with the Apache 2 license header file.


Then we will make sure that the newly created ONOS copyright profile is the default and we are done.

Navigating the source tree

At this point, the ONOS project should be fully processed and we are free to navigate and search the codebase.


Right clicking on the DefaultDevice implementation we can select various options, including Diagrams... where we can select Show Diagram… to reveal the UML of the class hierarchy for the DefaultDevice class.

Executing unit tests

Most IDEs allow developers to execute unit tests directly from the work-bench. IntelliJ is among them. There are many different ways to do this. For example, right-clicking on a section of the source tree, will execute all unit tests contained within.


This was just a quick overview of how to import the ONOS source code into the IntelliJ IDE. I hope you found this useful and I look forward to seeing your contributions to the codebase.