Your company here — click to reach over 10,000 unique daily visitors

mn - Man Page

create a Mininet network.


mn [options]


(type mn -h for details)

The mn utility creates Mininet network from the command line. It can create parametrized topologies, invoke the Mininet CLI, and run tests.


-h,  --help

show this help message and exit


default|ivs|lxbr|ovs|ovsbr|ovsk|user[,param=value...] user=UserSwitch ovs=OVSSwitch ovsbr=OVSBridge ovsk=OVSSwitch ivs=IVSSwitch lxbr=LinuxBridge default=OVSSwitch


cfs|proc|rt[,param=value...] proc=Host rt=CPULimitedHost{'sched': 'rt'} cfs=CPULimitedHost{'sched': 'cfs'}


default|none|nox|ovsc|ref|remote|ryu[,param=value...] ref=Controller ovsc=OVSController nox=NOX remote=RemoteController ryu=Ryu default=DefaultController none=NullController


default|ovs|tc|tcu[,param=value...] default=Link tc=TCLink tcu=TCULink ovs=OVSLink


linear|minimal|reversed|single|torus|tree[,param=value ...] minimal=MinimalTopo linear=LinearTopo reversed=SingleSwitchReversedTopo single=SingleSwitchTopo tree=TreeTopo torus=TorusTopo

-c,  --clean

clean and exit


read custom classes or params from .py file(s)



-x,  --xterms

spawn xterms for each node

-i IPBASE, --ipbase=IPBASE

base IP address for hosts


automatically set host MACs


set all-pairs ARP entries




sw and ctrl in namespace?


base port for passive switch listening


don't use passive listening port


CLI script to run before tests


CLI script to run after tests


pin hosts to CPU cores (requires --host cfs or --host rt)


[option=val...] adds a NAT to the topology that connects Mininet hosts to the physical network. Warning: This may route any traffic on the machine that uses Mininet's IP subnet into the Mininet network. If you need to change Mininet's IP subnet, see the --ipbase option.


prints the version and exits

-w,  --wait

wait for switches to connect

-t WAIT, --twait=WAIT

timed wait (s) for switches to connect


run on multiple servers (experimental!)


node placement for --cluster (experimental!)


June 2024 mn 2.3.1b4