≡ Menu

How to setup Linux as a router for DSL, T1 line etc

There are a few ways to set up a Linux machine as route. Here is a relatively straight forward and common method. This method requires that the system use iptables for Network Address Translation (NAT).

This step by step small howto will help you to setup Linux router only in 2 minutes.

Configuration steps

=> First enable packet forwarding
=> Next setup Network Address Translation using IPTABLES MASQUERADE targets
=> Save the changes
=> Verify everything is working

I’m assuming that your setup is as follows:
A) You are using any Linux distro

B) eth0 is internet interface (connected to router for example) and eth1 connected to your internal lan (connected to your HUB/Switch for example).

My Linux   eth0  --> Internet
box       eth1  --> Lan

Step # 1 Turn on ip forwarding in kernel

1) Open linux kernel configuration file (you must be a root user or use su – command to become a root user):
# vi /etc/sysctl.conf

2) Add/modify following line:
net.ipv4.ip_forward = 1

Step # 2 Restart network
# /etc/init.d/network restartOR# service network restart

Step # 3 Setup IP forwarding and Masquerading (to act as router), you need to use NAT option of iptables as follows (add following rules to your iptables shell script) :
# iptables --table nat --append POSTROUTING --out-interface eth0 -j MASQUERADE
# iptables --append FORWARD --in-interface eth1 -j ACCEPT

Step # 4 You are done! Test it with ping or dig:
# ping your-isp.com
# dig yahoo.com

Step # 5 Point all desktop client to your eth1 IP address as Router/Gateway. Or use DHCP to distribute this information (recommended)

Step # 6 Put code described in step # 3 to script and call it from /etc/rc.local file.

Share this on:

Your support makes a big difference:
I have a small favor to ask. More people are reading the nixCraft. Many of you block advertising which is your right, and advertising revenues are not sufficient to cover my operating costs. So you can see why I need to ask for your help. The nixCraft, takes a lot of my time and hard work to produce. If you use nixCraft, who likes it, helps me with donations:
Become a Supporter →    Make a contribution via Paypal/Bitcoin →   

Don't Miss Any Linux and Unix Tips

Get nixCraft in your inbox. It's free:

{ 30 comments… add one }
  • Anonymous October 16, 2005, 6:11 pm

    very useful, you got really good stuff. Keep it up.

  • Nandkishor March 29, 2007, 7:22 am

    Hi ,
    I put this rules, My client m/c able to ping to my internet router but not ping to any internet site like yahoo.com or google.com.
    Give me solution for this problem.

    • niti October 5, 2012, 10:25 am

      abe configuration to daal …..tabhi to solution milega na…

  • abhay naik May 8, 2007, 3:34 pm

    thanks for solution.

  • irfan July 2, 2007, 1:55 pm

    good tutorial,but i have a problem,i can ping IP of http://www.google.com, but i can`t ping http://www.google.com

  • nixCraft July 2, 2007, 2:51 pm

    Set up DNS name server by editing /etc/resolv.conf file:
    vi /etc/resolv.conf
    Modify/set as follows:



  • Michael D. Brogada July 27, 2007, 2:57 am

    using a client pc (xp box) i can ping my linux box 2 lan cards but i can’t connect to internet

    help pls. ;) thanks!

  • kumar August 18, 2007, 3:41 am

    How to do this if we are running windows?

  • sunil August 29, 2007, 11:17 am

    I do the above steps but cannot get internet from client machnies working in windows

  • Pawan Kinger September 4, 2007, 2:37 pm

    1. Those having problems like “…can ping the IP address but can’t ping the site…” you can use the DNS server in /etc/resolv.conf(open as root)
    2. those who can’t even ping the IP address ensure you have the right gateway specified in your network setttings.

  • Nandkishor September 14, 2007, 8:41 am

    But what Gatway is used for eth1.

    Cheer’s ,

    • Mike December 6, 2013, 6:43 pm

      Use Eth 0 gateway.

  • John Romo October 14, 2007, 4:21 am

    Will it work with a , it’s a dedicated line?

  • Chris March 19, 2008, 3:43 am

    I would be more than happy to pay you to make my headache go away!!!


    I’m so frustrated with routing and switching I could scream. I can’t ping any LAN computer from the router box.

  • Loke September 15, 2008, 12:23 pm

    My DSL modem is having static IP, example
    how to configure eth0 and eth1?

  • simon November 4, 2008, 9:18 am

    Guz Job well done on this tutorial.Am wondering whether when you are MASQUERADING AND FORWARDING you need to retain the comments on your script as shown that is

    # iptables –table nat –append POSTROUTING –out-interface eth0 -j MASQUERADE
    # iptables –append FORWARD –in-interface eth1 -j ACCEPT

    The comment symbol #

  • MIdhun June 4, 2009, 1:38 pm

    i can ping the linux server from clients. but can’t connect to internet from clients. in my network ETH1 is internet & ETHO is the link to client.. i am using debian etch. please help

  • MIdhun June 4, 2009, 1:40 pm

    i interchanged the ETH0 ETH1 during step3. still same problem …………….

  • Mustapha June 18, 2009, 1:59 pm

    I got everything working on CentOS 5.3. However iptables rules will not get saved unless you do # /etc/init.d/iptables save

    This will make your settings survive a reboot.

    * DNS is not working even when specifying it in /etc/resolv.conf

    I had to install bind on the router in cash-only mode.

  • Saidur Morsalin August 26, 2009, 1:11 pm

    Hi ,
    My client m/c able to ping to my internet router but not ping to any internet site like yahoo.com or google.com.
    Give me solution for this problem.

  • Sara September 6, 2009, 8:13 pm

    I have bought D-Link 2520U ADSL modem,
    my laptop model is SONY VGN-CR140E,
    and I use ubuntu 9.04, but I can not set up this modem on my laptop by LAN port. In fact I am beginner.
    Please help me to solve this problem.

    Thanks a lot.

  • Avin September 18, 2009, 1:05 pm

    Thanks for good tutorial, but I am confused about what is gateway address for eth1. Plz help

    Avin Tokade

  • bava October 24, 2009, 8:00 am

    pls, inform step by step, setup linux router configuration steps

  • chinni November 8, 2009, 6:33 pm

    pls, inform step by step, setup linux router configuration steps
    and of the material about the configuration of linux machine as router

  • muthu May 19, 2011, 10:10 am

    i am able to ping to my gateway of router but not ping to any internet site like yahoo.com or google.com.

  • marcuz February 4, 2012, 1:13 am

    thanks man. this is really good tutorial. I set up my Linux Router in just about minute after reading your post.

  • sen February 22, 2012, 7:19 am

    Hi Vivek,

    Great tutorial.
    I have configured a Linux router with DHCP server and it is working great.

    When I blocked an IP using the following rule on Server, I am not able to ping the IP from the linux router however this IPs are pinging from other systems on that LAN

    iptables -A OUTPUT -s -j DROP
    iptables -A INPUT -d -j DROP

    I am not sure why this is happening , any input on this will be very helpful.
    Also if you have any suggestion on an easy firewall on top of iptables on the Linux router ?


  • Tris March 26, 2012, 5:10 am

    Thank you !!! You really save my ass out. Been struggling for a whole day just try to ping google from client and now it works. :-x…..

  • Avin March 26, 2012, 6:41 am

    I have configured my Linux box as Router and I also used Squid (transparent mode) to improve our network bandwidth. Now I want to in my network client must pass my authentication (Username/ Password) but I found Squid Transparent mode not support authentication.

    Is there anyway to implement authentication for client ? Any third-party utility ?

  • Mike December 6, 2013, 6:40 pm

    Eth1 must have a gateway thru Eth0.

Leave a Comment

   Tagged with: , , , , , , , , , , , , ,