| Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision |
| docs:guide-quick-start:checks_and_troubleshooting [2020/04/22 14:49] – ↷ Links adapted because of a move operation tmomas | docs:guide-quick-start:checks_and_troubleshooting [2020/09/01 10:59] – [Troubleshooting your first steps with the new OpenWrt device] related links vgaetera |
|---|
| * or, if using OpenWrt SSH command line, you can use the command ''ping openwrt.org'' | * or, if using OpenWrt SSH command line, you can use the command ''ping openwrt.org'' |
| * This should return "0% packet loss" if everything is alright with your Internet connection | * This should return "0% packet loss" if everything is alright with your Internet connection |
| * A common source of internet connectivity failure is your OpenWrt and upstream WAN routers having conflicting IP address ranges. To correct this, adjust the OpenWrt router subnet by changing the [[docs:guide-user:base-system:basic-networking|network settings]] in the file ''/etc/config/network'' | * 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 [[docs:guide-user:base-system:basic-networking|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 192.168.1.1, 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 [[docs:guide-quick-start:ssh_connect_to_the_internet_and_install_luci|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 192.168.1.1 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 [[docs:guide-user:network:switch_router_gateway_and_nat| as a switch, router, or gateway]] | * Decide whether you want to use OpenWrt [[docs:guide-user:network:switch_router_gateway_and_nat| 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 [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]]. | * 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 [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]]. |
| |
| ===== Troubleshooting your first steps with the new OpenWrt device ===== | ===== Troubleshooting your first steps with the new OpenWrt device ===== |
| * If OpenWrt is configured as a router with default settings, you can access **[[http://openwrt.lan/|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 OpenWrt is configured as a router with default settings, you can access [[docs:guide-quick-start:walkthrough_login|LuCI web interface]] and [[docs:guide-quick-start:sshadministration|SSH command-line interface]] by [[http://openwrt.lan/|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: [[docs:guide-quick-start:developmentinstallation|development installation guide]]. Or verify the result on snapshot builds connecting to OpenWrt via SSH. | * If you have flashed a development/snapshot firmware of OpenWrt, you first need to [[docs:guide-quick-start:developmentinstallation|manually enable the web interface]]. Or verify the result on snapshot builds connecting to OpenWrt via [[docs:guide-quick-start:sshadministration|SSH]]. |
| * You can consult the troubleshooting section of the [[docs:guide-user:start|User Guide]], if you think that resetting OpenWrt's settings might help. | * You can consult the troubleshooting section of the [[docs:guide-user:start|User Guide]], if you think that resetting OpenWrt's settings might help. |
| * You can consult the [[https://forum.openwrt.org/c/installation|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. | * You can consult the [[https://forum.openwrt.org/c/installation|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. |