Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-quick-start:checks_and_troubleshooting [2018/02/20 19:46] – ↷ Page name changed from docs:guide-quick-start:first_steps to docs:guide-quick-start:checks_and_troubleshooting bobafetthotmaildocs:guide-quick-start:checks_and_troubleshooting [2020/09/01 10:59] – [Troubleshooting your first steps with the new OpenWrt device] related links vgaetera
Line 1: Line 1:
-===== First steps in your new OpenWrt device ===== +====== 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: 
-  - After your device has finished flashing and rebooting, check if you can access the LEDE web admin GUI of LEDE on LEDE's default IP address: http://192.168.1.1 +     * In the OpenWrt admin web interface, go to Network -> Diagnostics and Click on "ping" button 
-  - Login to the LEDE web GUI as "root" admin user with the password field empty +     * or, if using OpenWrt SSH command line, you can use the command ''ping openwrt.org''  
-  - Go to the System->Administration page and define a new password in both fields, then click Save and Apply (at the bottom of the page). +     * This should return "0% packet loss" if everything is alright with your Internet connection 
-  - This has verified that you can successfully use the LAN ports of your LEDE device. You now have a working LEDE device in its initial default configuration.  +     * 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. 
-Troubleshooting: +     * 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
-  * For this check only use an Ethernet cable, as WiFi is by default only enabled for devices that do not have Ethernet ports  +  * Decide whether you want to use OpenWrt [[docs:guide-user:network:switch_router_gateway_and_nat| as switch, routeror gateway]] 
-  * If you have flashed a development/snapshot firmware of LEDE, you first need to manually enable the admin web GUI: [[docs:guide-quick-start:developmentinstallation|development installation guide]]. Or verify the result on snapshot builds by SSH-connecting to your LEDE device IP 192.168.1.1 +  * 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'Wi-Fi legal regulations!**, e.g. see here for a first [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]]. 
-  * You can consult the troubleshooting section of the [[docs:user-guide:start|User Guide]], if you think that resetting LEDE's settings might help. +  * Consult the [[docs:guide-user:start|User Guide]] for more advanced configuration.
-  * You can consult the [[https://forum.lede-project.org/c/installation|Installing and Using LEDE 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. +
- +
- +
-===== Next steps ===== +
- +
-  * For a first quick Internet access test: If you have an existing router, connect the WAN port of your LEDE device to a LAN port of that router and confirm internet connectivity of your LEDE device with the following steps: +
-     * In the LEDE admin web GUI, go to Network -> Diagnostics and Click on "ping" button +
-     * or, if using LEDE SSH command line, you can use the command ''ping lede-project.org''  +
-     * This should return "0% packet loss" if everything is allright with your Internet connection. +
-  * Decidewhether you want to use LEDE [[docs:user-guide:general-info:switch_router_gateway_and_nat| as switch,  router or gateway]] +
-  * **When using your LEDE device as a WiFi access point, remember to initially set your country code in the LEDE WiFi configuration, to properly comply with your country'WiFi legal regulation!**, e.g. see here for a first [[docs:guide-quick-start:basic_wifi|basic WiFi setup]]. +
-  * Consult the [[docs:user-guide:start|User Guide]] for more advanced configuration.+
   * Install custom software packages that you might be interested in.   * Install custom software packages that you might be interested in.
  
-**Troubleshooting your first steps with the new LEDE device:** +===== Troubleshooting your first steps with the new OpenWrt device ===== 
-  * Do not worryif the 5 GHz WiFi does not seem to start immediately after having enabled it. It might be busy for 1-10 min scanning for weather radar, see [[docs:guide-quick-start:basic_wifi|basic WiFi setup]] for more background info. +  * 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 [[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 [[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. 
 +  * 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 [[docs:guide-quick-start:basic_wifi|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.    * 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 [[docs:guide-quick-start:ts-internetconnectivity|Troubleshooting Internet Connectivity]].+  * If needed, you can also take a look at [[docs:guide-quick-start:troubleshooting_internetconnectivity|Troubleshooting internet connectivity]]. 
  • Last modified: 2023/10/12 17:31
  • by micw