How to use Raspberry Pi as a wireless router with firewall?

raspberry pi firewall router

I wanted to build a router firewall on Raspberry Pi for a long time
I first tested Pfsense and OpenWRT with no success, and on a fresh Raspbian I was missing information
But now it’s ok, I finally found how to do it, and I’ll share this with you

How to use a Raspberry Pi as a firewall?
The Raspberry Pi only have one Ethernet socket, so it’s not possible to create a firewall with two RJ45 interfaces.
But there is a Wi-Fi interface that can be used for one side (LAN for example).
One way to build a firewall is to use the hostapd and iptables services.

And I’ll show you how
It’s a big topic with many softwares and network notions to understand
I’ll start with the theory and then explain how to install each software

Begin with the end in mind


A router is a network device that connects two networks together
If you have two ethernet ports on a computer, with different networks on each, your computer can act as a router


In this schema, we have two different networks, connected with a router: 1.0 and 2.0
If the router is well configured, it allows A and B to see each other, while on a different network

The Raspberry Pi have only one ethernet card, but we can use the WiFi card to create a second network
So, the router part in this tutorial will allow us to connect the WiFi network to the ethernet network


A firewall is a software. It allows us to add security policies in the router
For instance, in the previous example, we can configure that A can ping B, but not access the B http server
I’ll use a software called “iptables” for this, but you can use any other firewall software if you prefer

My goal

If you use your Raspberry Pi at home, you probably don’t need to connect two networks
But my goal is to create a new wireless access point with a firewall and other cool software to monitor the network and filter some kind of traffic

Here is my current network:

my current network

And I want to turn it like this:

So here are the steps you need to follow to do the same:

  • Install your Raspberry Pi on the network
  • Enable WiFi access point with a different network subnet
  • Create a bridge between the two networks
  • Create firewall rules
  • Install other cool softwares

I’ll explain you each step in detail
Let’s move to the first step of this process 🙂

Install your Raspberry Pi

The first thing to do is to install your Raspberry Pi on the network:

  • Install Raspbian by following this tutorial
    You don’t need the Desktop version, except if you want to use the Raspberry Pi for other things at the same time
  • Plug the Raspberry Pi on the network with an RJ45 cable
    We’ll use the WiFi later, so you need to let him available
  • A static IP address is not mandatory but it can help
    You can check the end of this article to know how to configure it
  • Once done, update your system by doing:
    sudo apt update
    sudo apt upgrade
    sudo reboot
  •  Enable SSH in raspi-config > Interfacing options
    sudo raspi-config
    You’ll use it in this tutorial, to copy/paste command from this page

That’s it, you have done the preparation step, we can start with the router installation

Install a wireless router

It’s possible to configure your Raspberry Pi as a WiFi router manually, but it’s a bit complex and time consuming
Thanks to Harry Allerston, there is a script available to do most of the work for us

  • The script is on GitHub, so we need to install git to download it:
    sudo apt install git
  • Move to a folder for the download and download it:
    cd /opt
    git clone
  • Move to the next sub directory
    cd RPI-Wireless-Hotspot/
  • Start the installation
    sudo ./install
  • The script will ask you several questions, here are the answers to give:
    • Are you sure that you wish to continue? Y
    • Do you want to use preconfigured DNS servers? Y
    • Do you wish to use Unblock-Us DNS servers? N
    • Do you wish to use OpenDNS DNS servers? Y
    • Do you want to use the wifi defaults? N
    • Then choose a password, an SSID and the channel to use (6 for example)
    • Are you using an rtl871x chipset (such as one purchased via adafruit)? N
    • Do you require Chromecast support for unblock-us? N
  • The Raspberry Pi will now reboot to apply changes

Once this is complete you should be able to use your Raspberry Pi as a Wi-Fi router

In your Wi-Fi networks list, you should see the chosen SSID:
wireless network

You can connect to it and check that everything is working as expected
You should get an IP in the subnet, the script created this network for you
There is nothing else to do for the network configuration
We can move to the firewall part

Understand the firewall concepts

I’ll start with an introduction on the theory about firewall configuration
If you are already fluent with this, you can move on to the next section


The role of a firewall is to block or allow access from a specific IP to another
And often we also use a port to set the exact permission
Ex: We deny port 22 to everyone, except computer A that can access computer B with port 22

Black or White

In a firewall configuration, you have the choice between two default rules:

  • Blacklist: Allow all except …
  • Whitelist: Deny all except …

Depending on what you want to do with your Raspberry Pi router, it’s your choice to take the one you want
Maybe at home the first is ok. You probably want to block only certain things like the torrent protocol or specific IPs address
But at work it’s rather the second. We forbid everything except what is allowed

In, Out and Forward

This one is easier
In your firewall you can create rules in three directions:

  • Input: Network packets coming into the firewall
  • Output: Packets going out from the firewall
  • Forward: Packets going through the firewall

On an hosted web server, you can block anything in input except HTTP and HTTPS
But in output it’s not a big deal what your server is doing on Internet

In our case, we’ll probably use FORWARD rules only as there is nothing on the Raspberry Pi
There is no need to protect it more than that

Configure the firewall service

If you want, you can add a firewall in your router to filter the traffic
Maybe at home it’s not mandatory, but for a company or a public place you need this


There are several firewall packages available on Raspbian: iptables or ufw for example
There is also OpenWRT, a Raspberry Pi compatible distribution to create a router firewall

In this post, I’ll use iptables, the most used
It’s already installed on your Raspberry Pi, so there’s nothing else to do

See the current configuration

Before adding rules, you need to check the current configuration
To do this, use the command:

sudo iptables -L

You should get something like that:

iptables list current configuration

We find the input, output and forward parts I talked about previously
For each we see that the default policy is ACCEPT, so everything allowed except what we add (blacklist mode)
And the GitHub script we launched already add basic rules in the FORWARD part to allow forwarding

You can use this command later to check if the new rules you’re adding correspond to what you want

Add a FORWARD rule

We’ll use the iptables command to add new rules in the firewall
Every network is different, so every firewall rules table is different
I’ll start by an example and then I’ll give you the whole syntax to add specific rules in your environment

  • Start by resetting the iptables configuration
    sudo iptables -F
    The rules order is important, and as the router already accept everything in the forward section, we are not able to block specific connections
  • Add a DROP rule
    iptables -A FORWARD -p tcp --dport 80 -j DROP
    This command specifies that:
    – we add a new rule (-A)
    – in the forward section (FORWARD)
    – for the tcp protocol (-p tcp)
    – for the HTTP port (–dport 80)
    – and the action is to DROP everything (timeout connection)
  • Check if it’s working
    Connect to the router WiFi
    You should not be able to access a website like this one for example

It’s ok, your first rule is operational

You can use iptables -F to remove the rule
Or you can use the same command with the -D operator instead of -A

iptables -D FORWARD -p tcp --dport 80 -j DROP

This allow you to delete a specific rule and not all like with the -F

Iptables command syntax

As you should already understand, you can now use the same command template to create the firewall rules you need

The command template is:

iptables -<operation> <direction> -p <protocol> --dport <port> -j <action>
  • operation:
    • -F: flush, remove all rules, it requires no other parameters
    • -A: append, add a new rule
    • -D: delete, remove an existing rule
  • direction: INPUT, OUTPUT or FORWARD (see the previous section)
  • protocol: mainly tcp or udp
  • port: the port number you want to create your rule for
    You can find a list of common ports here
  • action: Define the choice to make for the corresponding traffic
    • ACCEPT: Allow access (while in whitelist mode)
    • REJECT: Deny access and tell the sender it’s not allowed
    • DROP: Deny access but don’t tell the sender

This is the short introduction to what you’ll mainly use
If you need more information, use “man iptables” or check this page for all parameters

Switch to whitelist

As you can see with “iptables -L”, we are in blacklist mode: ACCEPT all except the rules we add

If you are in a stricter environment, switch to whitelist mode
For example, if you are creating a free WiFi in a hotel or other business, you probably want to allow only a few ports (like web and mails)

To do this, you need to create a list of all ports you want to allow
If you do all the commands manually, you’ll lose access after the first one 🙂
So, the easiest way is to create a script that run all commands at once

DNS issues

On my tests I had DNS issues because it’s a particular protocol which needs exchange between the two parts
It’s a complex configuration
The easiest way to fix this is to install a DNS forwarder on the Raspberry Pi and use it to answer DNS requests

To do this, follow these steps:

  • Install Bind (a DNS server package)
    sudo apt install bind9
  • Backup the original configuration
    sudo mv /etc/bind/named.conf.options /etc/bind/named.conf.options.old
  • Create a new configuration file
    sudo nano /etc/bind/named.conf.options
  • Paste these lines
    acl "localnetwork" {;; };
    options {
    directory "/var/cache/bind";
    forwarders {;
    allow-query { localnetwork; };
    dnssec-validation auto;
    auth-nxdomain no;
    listen-on-v6 { any; };

    This is a basic configuration
    We use OpenDNS as a forwarder, to send DNS query received on the Raspberry Pi to OpenDNS
    We allow access for the Wi-Fi clients
  • Save and Exit (CTRL+O, CTRL+X)
  • Restart Bind
    sudo service bind9 restart
  • Edit the DNS server in the DHCP in this file (to use the Raspberry Pi instead of OpenDNS directly)
    sudo nano /etc/udhcpd.conf
  • Change this line
    opt dns
  • To look like this :
    opt dns
  • It’s ok, you just need to restart the DHCP server
    sudo service udhcp restart
    Then reconnect your device and check that everything is fine

Create the firewall script

  • Create a new file with nano
    nano /usr/local/bin/
  • Paste these lines inside
    #Clear all rules
    iptables -F

    #Whitelist mode
    iptables -P INPUT ACCEPT
    iptables -P FORWARD DROP
    iptables -P OUTPUT ACCEPT

    #Allow PING for everyone
    iptables -A FORWARD -p icmp -j ACCEPT

    #Allow HTTP/HTTPS for WiFi clients
    iptables -A FORWARD -p tcp --dport 80 -j ACCEPT
    iptables -A FORWARD -p tcp --dport 443 -j ACCEPT

    #Allow POP/IMAP/SMTP for WiFi clients
    iptables -A FORWARD -p tcp --dport 25 -j ACCEPT
    iptables -A FORWARD -p tcp --dport 110 -j ACCEPT
    iptables -A FORWARD -p tcp --dport 993 -j ACCEPT

    #Allow PING for WiFi clients
    iptables -A FORWARD -p icmp -j ACCEPT

    You must adapt these lines to your needs
    This is just an example
    I don’t drop on INPUT and OUTPUT in this sample script, but you can do it if you want a better control on your network usage
  • Save and exit (CTRL+O, CTRL+X)
  • Add execution right to this script
    sudo chmod +x
  • Run it
    sudo /usr/local/bin/
  • Check if everything works fine
    If something goes wrong, reboot the Raspberry Pi to recover all access
    Then find what you miss in your script

When it’s ok, you can add it in the init tab to start it on boot

Make your configuration persistent

The GitHub script we installed before uses the file /etc/iptables.ipv4.nat to save the configuration
So once it’s working, you can save your current configuration inside :

sudo iptables-save > /etc/iptables.ipv4.nat

This will load the configuration file on load and apply directly the changes

Monitor the network

Now that the router is working (with a firewall or not), we can add other packages to improve the Raspberry Pi capabilities
In this part, I suggest adding a web interface to monitor what happens on the Raspberry Pi (and on the network)

What’s this tool?

The tool I chose is Webmin
It’s a web interface, easy to install, that shows you all the current configuration, and several statistics and graphs about the system usage
You can even change the configuration from this interface

If you know other ones tell me in the comments
It’s a tool that exists for a long time, but I don’t know a more recent one to do this

Webmin Installation

  • Check the latest Webmin version from this page (Source file)
  • Download the file like this:
  • Extract the archive and move to the new folder
    tar -zxvf webmin-1.900.tar.gz cd webmin-1.900
  • Run the setup
    sudo ./ /usr/local/webmin
    Keep all the default values
    Set a password and choose if you want to use SSL or not
    Wait a few seconds for the installation to finish
  • The tool is now available at http://<IP>:10000
    Log in with the user name and password you just created

Webmin interface

I let you discover the web interface and browse through the menu
There are A LOT of tools inside, we don’t need all of this
We’ll mainly use those in the “Networking” part

For example, you can enable bandwidth monitoring or manage your firewall configuration from here


We’ll come back later to this interface, for the proxy configuration for example
It’s the next part

Add a proxy and a web filter

What’s a proxy?

A proxy has three main roles:

  • Creating a cache of all Internet pages, to increase web browsing speed
  • Log all pages, to generate reports (top domain, top traffic, …)
  • And we can add a website blocker, to deny access to some kinds of content

To do this, we’ll install Squid (the proxy) and SquidGuard (the filter) on the Raspberry Pi

Squid installation

  • Squid is available in the repository. Install it with:
    sudo apt install squid
  • Backup the configuration file
    cd /etc/squid sudo
    mv squid.conf squid.conf.old
  • Switch to the root user a few seconds and remove all the comments quickly
    sudo su
    cat squid.conf.old | egrep -v -e '^[[:blank:]]*#|^
  • Then edit the configuration file
    sudo nano squid.conf
  • And add these lines at the beginning
    acl LocalNet src
    http_access allow LocalNet

    Squid works only on HTTP for the Wi-Fi network (42.X)
  • Restart Squid to apply changes
    sudo systemctl restart squid

Once Squid is configured, you have two choices to use it:

  • Configure your web browser to use the Raspberry Pi as the HTTP Proxy
    It depends on your browser, but you should find this option in Options > Network settings
  • Configure iptables to redirect automatically all HTTP traffic to squid
    It should be something like this:  
    iptables -t nat -A PREROUTING -i wlan0 -p tcp --dport 80 -j DNAT --to
    iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 3128

Then check that HTTP websites are working fine
You can see all the websites visited in the Squid log file :

sudo tail -f /var/log/squid/access.log

Webmin add-on

There is a Webmin add-on called “calamaris” you can install to monitor the proxy efficiency
Install it with apt:

sudo apt install calamaris

And then go back to webmin, in the unused modules to find new tools for squid monitoring

SquidGuard installation

We can now move to the SquidGuard installation:

  • Install the squidguard package
    sudo apt install squidguard
  • Download a list of websites by category
  • Extract files from the archive
    tar -zxvf blacklists.tgz
    While extracting, you’ll see some blacklist categories appear on your screen
    You can choose one and use it for the SquidGuard configuration later
    You can open the files to get some websites examples
  • Move files to the SquidGuard folder
    sudo mv blacklists /var/lib/squidguard/db
  • Archive the original SquidGuard configuration file
    cd /etc/squiguard
    mv squidGuard.conf squidGuard.conf.old
  • Create a new configuration file
    sudo nano squidGuard.conf
  • Paste these lines
    dbhome /var/lib/squidguard/db logdir /var/log/squidguard dest violence {
    domainlist blacklists/violence/domains
    urllist blacklists/violence/urls
    log violenceaccess
    acl {
    pass !violence
    redirect http://localhost/block.html
    } }

    This is a sample file, you can block whatever you want
    You can also add more categories by creating more dest sections
  • Save and exit (CTRL+O, CTRL+X)
  • Build the SquidGuard database
    sudo squidGuard -C all -d
    This can take a long time. If it’s too long, remove files you don’t need from the blacklists folder
    Use a screen if you don’t stay in front of your computer (screen -S build)
    So if the SSH connection with your computer is lost, this will not stop the build process
  • Restart Squid to apply changes
    sudo service squid restart

It should be ok now, try to access an URL from the domain list and check that you are blocked by squidGuard

Related questions

Is it possible to add an Ad Blocker brick in this router? Yes, you can use Pi-Hole to do this, it’s easy to install and you just need to set the Raspberry Pi as your DNS server (manually or in the DHCP configuration file, see Firewall > DNS issues for more information)

Is it possible to use a Raspberry to build a “full ethernet” router? Yes, you can add an ethernet hat to your Raspberry pi like the POE-Hat (check the price on Amazon). I didn’t test it, but it should do the job


That’s it, you should now have a better knowledge on how to build a complete firewall router with proxy on a Raspberry Pi

I hope it’s working for you.
It took me a lot of time to write this post with many tests I didn’t include here, but you have the most important things, with the best tools
If you have any issues, ask your question in the comments, we’ll try to help you

Also, these tools are basically Linux stuff and you can find a lot of help on the Internet to go further

I give you all the documentation links here if needed:

raspberry pi wireless firewall

How useful was this post?

Click on a star to rate it!

Average rating 4.7 / 5. Vote count: 3

No votes so far! Be the first to rate this post.

As you found this post useful...

Spread the word!

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

How to use Raspberry Pi as a wireless router with firewall?


  1. Peter Stuart Reply

    interesting way to use the RPi. Just wondering what the config would be using a USB to eth adapter instead of WifI.
    best regards

    • Patrick Fromaget Post authorReply


      I think it would only change the interface name, I can test it if you want
      And yes, you can absolutely add a torrent client on this installation


  2. Umur Reply

    Hello nice document , i have a question which version of raspi should i use? I have raspberry pi one B version and 3 only… Should i buy raspi 4 models? Thanks alot alot…

    • Patrick Fromaget Post authorReply

      Hi Umur,

      I’ve done this tutorial with a Raspberry Pi 3B+ so it’s ok

      If the question is general, the Raspberry Pi 4 only add extra performances, so it depends on what you want to do

  3. James Fargo Reply

    Hi, I would only be interested in the raspberry router, leaving aside the rest that seems quite complicated to me, beginner. The raspberry router clearly coexists with a modem. Your site is really useful, good!

  4. James Fargo Reply

    Hi, I followed the instructions for the Wireless router installation.
    But something went wrong, I probably did something wrong.
    Fact is, the wireless raspberry doesn’t work.
    Could I get a little help?
    Thank you in advance.

    • Patrick Fromaget Post authorReply

      Hello James,

      Did you get an error?
      Which part are you stuck in?


  5. Kannan Reply

    Nice Project
    i have few questions
    1. i am using ssh to login the pi with static IP so will i be able to still do the above wireless router part?
    2. is there a way to implement IDS with alert notifications (email or sms)

    • Patrick Fromaget Post authorReply


      1. Yes, but only if the computer doesn’t use the Wi-Fi router (if not you have to use the IP on the Wi-Fi network)

      2. I think that Snort would work on this installation, but I didn’t try it


  6. Hanif Rizal Reply

    Hi Patrick,

    what a great tutorial! I would love to try this as soon as i can!
    Can this be able to work with Pi-Hole?

  7. Mohammad Reply

    Nice project
    How can i force user to brows a local home page imidiatly after connecting to wifi?

    • Patrick Fromaget Post authorReply

      Hi Mohammad,

      The word you are looking for is “captive portal”
      Even if I never tested it on Raspberry Pi, it should be possible
      You need to install a Radius server for the authentication

      You will easily find tutorial for Linux
      Nodogsplash seems a good solution:

      Let me know if you find a solution
      And if others are interested, I could probably try it and share how to do this

Leave a Reply to James Fargo Cancel reply

Your email address will not be published. Required fields are marked *