How to configure management IP address in SONiC?

STORDIS_Mikołaj Walczak
Updated

Table of Contents

 

Introduction

Welcome to the STORDIS Support Portal guide!

This article explains how to configure a management IP address on a SONiC-based switch for out-of-band administration.

The management port (eth0) is used for out-of-band (OOB) access to the switch. Proper configuration of a management IP address allows administrators to:

  • Access the switch remotely (SSH)
  • Perform software upgrades
  • Monitor and troubleshoot the device
  • Integrate the switch into management systems

This guide explains how to configure static IP addressing on the management interface.

 

Prerequisites

Before starting the configuration, ensure you have the following:

  • Console terminal software: PuTTY, Teraterm, SecureCRT, etc.
  • Installed SONiC on the switch.
  • Console access to the SONiC switch.
  • Serial Console cable: Provided with the device.
  • Basic Linux CLI knowledge.

 

Topology

Configure Management Port

By default, the management interface (eth0) obtains an IP address via DHCP.

To check the current configuration:
show ip interface

 

Configure a Static IP Address

Add a static IP address:
sudo config interface ip add <interface_name> <ip_addr> <default
 gateway IP address>

Example:

sudo config interface ip add eth0 192.168.1.50/24 192.168.1.254

 

Verify changes:
show ip interface

 

Configure VRF

Important:
In SONiC, the management interface (eth0) can't be bound to a custom VRF.

Create a VRF:
sudo config vrf add mgmt

 

Save changes:
sudo config save -y

 

Verify VRF and interfaces status:
show mgmt-vrf

 
Verify IP configuration:
show ip interface

 

Verify routing table:
show ip route
show ip route vrf mgmt

 

Congratulations!

You have successfully configured the management IP address on your SONiC switch.

The device is now accessible through the management network for remote administration, monitoring, and maintenance tasks.

 

Before concluding, ensure that:

  • The IP configuration is saved (sudo config save -y).
  • SSH access is verified from a remote host.

  • Connectivity to the management network is confirmed.

     

If you have any questions related to this article, feel free to reach out to our technical support team.

Happy Networking!

 

Useful links

Official SONiC repository

 

If you want to explore more topics, be sure to check out our other guides, including:

How can I set up a console connection to Edgecore Open Networking switch?

How to upgrade SONiC to a newer version?

How to add user and change the password in SONiC

How to configure the port breakout in SONiC?

Where to download the SONiC Virtual Switch (VS) community pre-built image?

 

For more free resources, visit: 

https://stordis.com/free-resources/

 

Still have questions? You can find more answers in our full FAQ - just follow the link below.

STORDIS Support Portal FAQ

Comments 0

Articles in this section