From SME Server
Jump to navigationJump to search


Daniel B. from Firewall Services


Contrib 10:
Contrib 9:
The latest version of smeserver-bridge-interface is available in the SME repository, click on the version number(s) for more information.


smeserver-bridge-interface is a small package allowing you to bridge your Internal Interface with one or more virtual tap interfaces. It's main goal is to be used with the new OpenVPN-Bridge contrib, but it has been split in another contrib as it can be used in other situations (if you want to run a virtual machine on your SME Server with qemu for example).


  • SME Server 7.X
  • SME Server 8.X
  • SME Server 9.X


  • install the rpms
yum --enablerepo=smecontribs install smeserver-bridge-interface
  • for SME9
yum --enablerepo=smecontribs install smeserver-bridge-interface
  • Configure the bridge

Log into your server using SSH, and configure the bridge like you want. For most installation, the default settings should be OK, but you should check it:

db configuration show bridge

    • bridgeInterface: (br0) is the name of the bridge device (usually br0)
    • ethernetInterface: (eth0|eth1) is the real interface you want to bridge. It should already be set to your actual InternalInterface
Warning.png Warning:
The bridge contrib is not compatible with the NIC bonding option. If you're running in serveronly mode and use NIC bonding, you should disable it before starting the bridge. To do so, you can use the admin console, either by loging in as the admin user, or as root, and then type the command console

    • tapInterface: (tap0,tap1) is a comma separated list of tap interfaces to create and add to the bridge. Usually, you'll only need one tap interface (tap0)
    • status: (enabled|disabled) is the status of the service (should it be started automatically on boot)

Once you're sure everything is ok, just start the service:

/etc/init.d/bridge start

And check with ifconfig that everything is OK (eth0 and tap0 should have IP and running in promiscous mode, br0 should have the IP of your Internal Interface)

You can also check the bridge is correctly configured

brctl show br0

Should output something like:

bridge name     bridge id               STP enabled     interfaces
br0             8000.00e04c101418       no              eth0


If you remove this contrib while it's in use, you may have a problem shuting down br0 (waiting for br0 to become free etc...), and you'll have to hard reboot your server. To prevent this you should

  • Disable the service
db configuration setprop bridge status disabled
Warning.png Warning:
Remember that if you disable the service, OpenVPN_Bridge will stop working, so if you have it installed, you should disable or remove it too

  • Reboot your server, the bridge wont start
  • Remove the rpm
yum remove smeserver-bridge-interface
Warning.png Warning:
signal-event post-upgrade;signal-event reboot may be required in case the system looses the internal interface


The source for this contrib can be found in the smeserver CVS on sourceforge.


Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-bridge-interface component or use this link

IDProductVersionStatusSummary (4 tasks)
12271SME Contribs10.0VERIFIEDDHCP Not working since last updates - smeserver-bridge-interface is impacted
12260SME Contribs10.0CONFIRMED** Ignoring requests on br0. If this is not what
8644SME Contribs8.1CONFIRMEDmulticast_snooping
6919SME Contribs8.0UNCONFIRMEDCan not access internet after switch from servergateway to serveronly and back again


Only versions released in smecontrib are listed here.

smeserver-bridge-interface Changelog: SME 10 (smecontribs)
2022/12/25 Terry Fage 0.2-9.sme
- make bridge interface compat to e-smith-base on install [SME: 12271]
2022/12/16 Terry Fage 0.2-8.sme
- make bridge interface up on install [SME: 12271]

2021/03/23 Jean-Philippe Pialasse 0.2-7.sme
- make bridge interface up on install [SME: 11485]

- modify support for dhcp with bridge
2021/01/28 Brian Read 0.2-6.sme
- Change-After-in-Service-file-to-network-service-from-target [SME: 11324]
2021/01/24 Brian Read 0.2-5.sme
- Add-Restart-to-service-file.patch [SME: 11324]