FreeBSD Set a Default Route / Gateway

last updated in Categories , , , ,

How do I modify or set a default route for my FreeBSD server? How do I make default route configuration persistent?

You need to use the route command on a FreeBSD to manually manipulate the network routing tables. It provides six commands as follows:


  1. add : Add a route.
  2. flush :Remove all routes.
  3. delete : Delete a specific route.
  4. change : Change aspects of a route (such as its gateway).
  5. get : Lookup and display the route for a destination.
  6. monitor : Continuously report any changes to the routing information base, routing lookup misses, or suspected network partitionings.

Task: View / Display FreeBSD Routing Table

Use the netstat command with -r option as follows:
$ netstat -r
$ netstat -rn

Sample outputs:

Routing tables
Destination        Gateway            Flags    Refs      Use  Netif Expire
default            61.221.xx.yy       UGS         0      247    em1
10               UGS         0       50    em0
10.10.110/26       link#1             UC          0        0    em0        00:1b:0d:e6:58:40  UHLW        2        0    em0   1145
61.221.xx.yy/29    link#2             UC          0        0    em1
61.221.xx.yy       00:1b:0d:e6:57:c0  UHLW        2        0    em1   1055
61.221.xx/24       link#2             UC          0        0    em1          UH          0        0    lo0

The first two line displays default routes. To just print IPv4 routing table, enter:
# netstat -4 -r -n
Sample outputs:

Fig.01: FreeBSD Display Default Routing Table Command
Fig.01: FreeBSD Display Default Routing Table Command

To just print IPv6 routing table, enter:
# netstat -6 -r -n

Task: FreeBSD Set a default route

All network packets that cannot be sent according to the previous entries of the routing table are sent through the following default gateway:
# route add default

How do I save routing information to a configuration file?

If you reboot FreeBSD box, the routing configuration will be lost i.e. the routing information will not persist. You need to edit /etc/rc.conf file to set defaultroute:
# vi /etc/rc.conf
Set default route by editing defaultrouter variable:
Save and close the file.

Task: Start and Stop FreeBSD Configured Interfaces

To apply changes to a configuration file, you need to stop and restart the corresponding FreeBSD networking interface. The following command will also update routing information:
# /etc/rc.d/netif restart
# /etc/rc.d/routing restart

# service netif restart
# service routing restart

How can I change or the default gateway from the FreeBSD CLI?

Use the following commands:
### [ delete the default route/gateway ] ###
# route del default
### [ now setup as the default gateway for my FreeBSD box ] ###
route add default

Verify it:
# netstat -r -n

Further readings:
  • Read man pages netstat, route, rc.conf, service


Posted by: Vivek Gite

The author is the creator of nixCraft and a seasoned sysadmin, DevOps engineer, and a trainer for the Linux operating system/Unix shell scripting. Get the latest tutorials on SysAdmin, Linux/Unix and open source topics via RSS/XML feed or weekly email newsletter.

9 comment

  1. # /etc/rc.d/netif restart
    # /etc/rc.d/netif stop
    # /etc/rc.d/netif start
    these commands make two times the same action: up down the interface.
    But these commands don’t renew the routes. to renew the route you must do
    /etc/rc.d/routing stop
    /etc/rc.d/routing start

  2. Please change
    /etc/rc.d/routing stop
    /etc/rc.d/routing start


    /etc/rc.d/routing restart

    Most of the time one will be on a ssh session, above commands leads to
    big problems, latter one is always safer.

    Still, have a question? Get help on our forum!