User Tools

Site Tools


Internet connectivity and troubleshooting

  • For a first quick Internet access test: If you have an existing router, connect the WAN port of your OpenWrt device to a LAN port of that router and confirm internet connectivity of your OpenWrt device with the following steps:
    • In the OpenWrt admin web interface, go to Network → Diagnostics and Click on “ping” button
    • or, if using OpenWrt SSH command line, you can use the command ping
    • This should return “0% packet loss” if everything is alright with your Internet connection
    • If your device has two (or more) ethernet ports, maybe OpenWrt and upstream WAN routers having conflicting IP address ranges. To correct this, adjust the OpenWrt router subnet by changing the network settings in the file /etc/config/network
    • if the device has a single port, it's probably configured as a router anyway because that's what OpenWrt usually does so it has a static IP, no gateway or dns server set up so it won't connect to the Internet (or even local network if it is not 192.168.1.x) in this state. Connect to Luci web interface at the mentioned IP address and change the LAN interface settings to add the IP of your router as gateway and DNS server. If you have only SSH or console access, please see the Use SSH to connect to the internet and install Luci Web interface article.
    • if the device has a single port and you can't access it from the default IP address of then it was set by default with a dynamic address (some NAS devices in OpenWrt have that default setting), and you need to check your modem/router's “connected devices” page to see what IP your OpenWrt received from it. In this case the device should be able to access the internet because it has received the IP, gateway and dns setting from the line above.
  • Decide whether you want to use OpenWrt as a switch, router, or gateway
  • When using your OpenWrt device as a Wi-Fi access point, please remember to initially set your country code in the OpenWrt Wi-Fi configuration, to properly comply with your country's Wi-Fi legal regulations!, e.g. see here for a first basic Wi-Fi setup.
  • Consult the User Guide for more advanced configuration.
  • Install custom software packages that you might be interested in.

Troubleshooting your first steps with the new OpenWrt device

  • If OpenWrt is configured as a router with default settings, you can access LuCI web interface and SSH command-line interface by domain name. If OpenWrt is configured as a network client, switch or access point, use its IP-address explicitly. You can utilize a network scanner or status page of your main router to find out OpenWrt IP-address.
  • If you have flashed a development/snapshot firmware of OpenWrt, you first need to manually enable the web interface. Or verify the result on snapshot builds connecting to OpenWrt via SSH.
  • You can consult the troubleshooting section of the User Guide, if you think that resetting OpenWrt's settings might help.
  • You can consult the Installing and Using OpenWrt forum section, if something went wrong. Please provide specific details of your device and what you did so far and what you have attempted to fix it.
  • Do not worry if the 5 GHz Wi-Fi does not seem to start immediately after having enabled it. It might be busy for 1-10 min scanning for weather radar, see basic Wi-Fi setup for more background info.
  • Note that you can always run logread on the SSH command line, to gain more insight into what the device is currently doing or to diagnose any kind of problems.
  • If needed, you can also take a look at Troubleshooting internet connectivity.
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
docs/guide-quick-start/checks_and_troubleshooting.txt · Last modified: 2020/09/01 10:59 by vgaetera