Router Mode is Local’s way of offering the best offline development experience possible while still “playing nice” with other, similar development applications.<\/p>\r\n\r\n\r\n\r\n
You can access this setting by navigating to “Preferences > Advanced > Router Mode,” where you will find two options:<\/p>\r\n\r\n\r\n\r\n
- \r\n
- Site Domains<\/strong> Router Mode\r\n
- \r\n
- The default mode that Local runs. In this mode, Local will start a “router” that listens on port 80 and directs traffic to the individual sites that Local manages. The domain for each site will look something like
example.local<\/code><\/li>\r\n<\/ul>\r\n<\/li>\r\n\r\n\r\n\r\n- localhost<\/strong> Router Mode\r\n
- \r\n
- This fallback mode doesn’t start the Local router and instead, each site is reached directly using a dedicated port on the computer. Using this mode means that the domain will look something like
localhost:10005<\/code><\/li>\r\n<\/ul>\r\n<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\nHow Local Works<\/strong><\/h2>\r\n\r\n\r\n\r\n
Ok, that’s a lot of jargon, so if you’re confused, it might help to zoom out a bit and understand how the different Local parts work.<\/p>\r\n\r\n\r\n\r\n
In general, the software that serves up web pages “listens” for requests and then generates a “response” for that request. The actual location that these pieces of software listen to is called a port. For example, the default port for requests made over HTTP is port
80<\/code>, while requests made over HTTPS is port443<\/code>.<\/p>\r\n\r\n\r\n\r\nSince only one piece of software can listen to a port at one time, Local has to figure out a way to serve multiple sites from the same HTTP port (port
80<\/code>).<\/p>\r\n\r\n\r\n\r\nLocal does this by doing two things:<\/p>\r\n\r\n\r\n\r\n
- \r\n
- Each site that Local manages is given a random port number to listen to, for example,
10005<\/code>. Those sites can be accessed directly by appending the port tolocalhost<\/code>, which looks like:localhost:10005<\/code>.<\/li>\r\n\r\n\r\n\r\n- A “router” is created and is listening on port
80<\/code>. This router is responsible for translating a meaningful domain likeexample.local<\/code> into the actual site listening on a specific port: ie,localhost:10005<\/code>.<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\nWhen using “Site Domains” router mode, the browser connects to port 80 and Local’s router then connects to the appropriate port for each individual site.<\/p>\r\n\r\n\r\n\r\n
<\/div>\r\n\r\n\r\n\r\n![\"\"](\"https:\/\/localwp.com\/wp-content\/uploads\/2023\/07\/image-9.png\")
<\/figure>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\nWhen using
localhost<\/code> router mode, the browser connects directly to the port that each site is listening on. This allows another process to listen on port 80, but it also means some diminished functionality when interacting with those sites.<\/p>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\n![\"\"](\"https:\/\/localwp.com\/wp-content\/uploads\/2023\/07\/image-10.png\")
<\/figure>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\nWhat Happens When Local Can’t Start The Router?<\/strong><\/h2>\r\n\r\n\r\n\r\n
Hopefully, that additional context helps visualize how Local is configured. As you might imagine, things can break when the router isn’t able to start \u2013 the most obvious thing that breaks is that you can’t use meaningful domains like
example.local<\/code>. Instead, you would have to remember the port number for each site.<\/p>\r\n\r\n\r\n\r\nIn most cases, Local can’t start the router because there is something<\/em> already occupying port
80<\/code>. There are only two options to get things working:<\/p>\r\n\r\n\r\n\r\n- \r\n
- Set Local to use
localhost<\/code> Router Mode.<\/li>\r\n\r\n\r\n\r\n- Stop whatever is already listening on port 80 and restart Local.<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n
<\/div>\r\n\r\n\r\n\r\nUsing
localhost<\/code> Router Mode<\/strong><\/h2>\r\n\r\n\r\n\r\nOf the two modes that Local can use, setting the router mode to
localhost<\/code> is the easiest and allows Local to run while other applications are using the default HTTP port of80<\/code>. If you go this route, there are some limitations when usinglocalhost<\/code> router mode:<\/p>\r\n\r\n\r\n\r\n- \r\n
- Sites can’t use HTTPS<\/strong>. Because Local can’t manage the
localhost<\/code> SSL certificate, there’s no way for Local to make the sites accessible over HTTPS.<\/li>\r\n\r\n\r\n\r\n- Sites can’t use Live Links<\/strong>. The router handles part of the magic of using live links.<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n
<\/div>\r\n\r\n\r\n\r\nSelecting the Router Mode from the “Advanced” section of the Preferences screen.<\/p>\r\n\r\n\r\n\r\n
<\/div>\r\n\r\n\r\n\r\n![\"\"](\"https:\/\/localwp.com\/wp-content\/uploads\/2023\/07\/image-11.png\")
<\/figure>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\nWhen in
localhost<\/code> Router Mode, the Site Host will havelocalhost<\/code> and the port number for the site.<\/p>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\n![\"\"](\"https:\/\/localwp.com\/wp-content\/uploads\/2023\/07\/image-12.png\")
<\/figure>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\nStopping Whatever Is Listening On Port 80<\/strong><\/h2>\r\n\r\n\r\n\r\n
If you want to use all of the features that Local offers, then running in the default “Site Domains” router mode is required. In most cases, this is seamless, but if you are unsure about what piece of software is already listening on port 80, it can be challenging to zero in on where the conflict is.<\/p>\r\n\r\n\r\n\r\n
Mac<\/strong><\/h3>\r\n\r\n\r\n\r\n
The quickest way to zero in on what is listening on port
80<\/code> is to open a terminal and issue this command, which will prompt you for your computer password.<\/p>\r\n\r\n\r\n\r\nsudo lsof -i:80; sudo lsof -tnP -i:80 | xargs -n 1 ps -p<\/code><\/pre>\r\n\r\n\r\n\r\nIf you’re curious about what this command is doing, it’s basically:<\/p>\r\n\r\n\r\n\r\n
- \r\n
- Listing all the “open files” on port 80<\/li>\r\n\r\n\r\n\r\n
- Listing more details about the process that’s running on port 80<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n
With that additional info, you should be able to shut down that application gracefully, but if you need to kill that process forcefully, you can do so from within a terminal:<\/p>\r\n\r\n\r\n\r\n
kill <process-id><\/code><\/pre>\r\n\r\n\r\n\r\nUnder Windows, finding those processes that are listening on Port 80 can be a little more tricky and might need to do some examining with the Task Manager. <\/p>\r\n\r\n\r\n\r\n
One thing that can help is to use
cmd.exe<\/code> to run the following commands to help drill down to the actual processes that are listening on port 80.<\/p>\r\n\r\n\r\n\r\nNote: make sure to replace
<process-id><\/code> with whatever process you found in the first command:<\/p>\r\n\r\n\r\n\r\nnetstat -nao | find \"80\"\r\ntasklist \/v \/fo list \/fi \"pid eq <process-id>\"<\/code><\/pre>\r\n\r\n\r\n\r\nHopefully, that points you to the application that’s listening, as well as give you enough info to investigate further. <\/p>\r\n\r\n\r\n\r\n
As an example, here are a couple of screenshots of investigating and disabling the built-in IIS server that is enabled by default for some versions of Windows.<\/p>\r\n\r\n\r\n\r\n
![\"\"](\"https:\/\/localwp.com\/wp-content\/uploads\/2020\/12\/router-mode-finding-windows-port-80-1024x667.png\")
<\/a>A screenshot showing how to use the output from the netstat<\/code> command to zero in on the actual process in the Task List. From there, additional info can be found by right-clicking on the process and selecting “Properties.”<\/figcaption><\/figure>\r\n\r\n\r\n\r\n![\"\"](\"https:\/\/localwp.com\/wp-content\/uploads\/2020\/12\/router-mode-windows-built-in-server-1024x582.png\")
<\/a>Using the information from the previous image, we can do an internet search for ntoskrnl windows port 80<\/code>. This lead me to disable the built-in IIS server from within Windows Features.<\/figcaption><\/figure>\r\n\r\n\r\n\r\n<\/div>\r\n\r\n\r\n\r\nChanging Router Mode<\/h2>\r\n\r\n\r\n\r\n
If the router mode is changed, some additional steps need to happen for the site to work with the new Router Mode.<\/p>\r\n\r\n\r\n\r\n
Local will occasionally check to see if the domain within the database matches what it thinks the domain should be. If those are different, it will prompt you to “fix it”. In the case of switching to
localhost<\/code> router mode, Local will search forexample.local<\/code> and replace it with the appropriate port number, something likelocalhost:10005<\/code>.<\/p>\r\n\r\n\r\n\r\nA similar process happens when switching back to “Site Domain” router mode.<\/p>\r\n\r\n\r\n\r\n
- Sites can’t use Live Links<\/strong>. The router handles part of the magic of using live links.<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n
- Stop whatever is already listening on port 80 and restart Local.<\/li>\r\n<\/ol>\r\n\r\n\r\n\r\n
- A “router” is created and is listening on port
- Each site that Local manages is given a random port number to listen to, for example,
- localhost<\/strong> Router Mode\r\n
- The default mode that Local runs. In this mode, Local will start a “router” that listens on port 80 and directs traffic to the individual sites that Local manages. The domain for each site will look something like
![\"\"](\"https:\/\/localwp.com\/wp-content\/uploads\/2020\/12\/router-mode-finding-windows-port-80.png\")
<\/a>