Clone this repo:
  1. 3b8a34a VOL-5142 - Create beta-release branch for ofagent-go by Joey Armstrong · 6 weeks ago master
  2. ae4e525 VOL-5115 - Create release branch voltha-2.12-beta by Joey Armstrong · 7 weeks ago v2.12.0
  3. 82f98dd VOL-5088 v2.12 - update voltha.protos version in all go.mod configs by Mahir Gunyel · 9 weeks ago v2.1.5 v2.12.0-beta
  4. b173c5c [VOL-5052] - Pre-release triage build for ofagent-go by Joey Armstrong · 3 months ago
  5. 5a89e11 Post release: bump version string for development by Joey Armstrong · 8 months ago v2.11.0


Ofagent-go provides an OpenFlow management interface for Voltha. It is a rewrite in Golang of the original ofagent that was written in python / twisted. The main driver behind the work was to introduce true concurrency to the agent for performance/scalability reasons.


  1. Outside $GOPATH

    1. Read-only git clone
    2. To Contribute git clone
  2. Compile go build -mod=vendor -o ./build/ofagent-go


  • Normal Logging
    • ./build/ofagent-go -ofaddress=localhost openflowPort=6653 -volthaAddress=localhost -volthaPort=50057
  • Debug Logging
    • ./build/ofagent-go -debug -ofaddress=localhost openflowPort=6653 -volthaAddress=localhost -volthaPort=50057

Building with a Local Copy of voltha-protos or voltha-lib-go

If you want to build/test using a local copy or voltha-protos or voltha-lib-go this can be accomplished by using the environment variables LOCAL_PROTOS and LOCAL_LIB_GO. These environment variables should be set to the filesystem path where the local source is located, e.g.


When these environment variables are set the vendored versions of these packages will be removed from the vendor directory and replaced by coping the files from the specified locations to the vendor directory. NOTE: this means that the files in the vendor directory are no longer what is in the git repository and it will take manual git intervention to put the original files back.