Out of the box Lando uses an actual on-the-internet wildcard domain at
*.lndo.site to route your domain names back to your localhost to provide convenient proxying. This method is minimally invasive and doesn't require Lando to alter your machine's DNS routing. This has the downside of requiring an internet connection to access your sites.
However, you may want the freedom of hacking away on your site while scaling Everest or just to simply route your projects to a different wildcard domain, like
*.my.test. Note that we DO NOT recommend you use a true top-level domain such as
*.test. You can read more about why in our security documentation.
To enable offline custom domain goodness, we'll use DNSMasq to route traffic to our local system and add a single config line to our global Lando config to direct lando to use that domain for our sites.
Mac Specific Instructions
- Ensure you've installed Homebrew.
- Install DNSMasq:
brew install dnsmasq
- Follow the instructions in the output of
brew info dnsmasq
- Add the following line to your
Sub in your favorite domain for 'local.host' here if you want to use something more flashy.
- Restart DNSMasq:
brew services restart dnsmasq
- For macOS to resolve requests from *.local.host to localhost we need to add a resolver:
sudo mkdir -p /etc/resolver sudo nano /etc/resolver/local.host
- Add the following line to the local.host file resolver in /etc/resolver/.
- Reboot macOS to enable the new resolver.
- Flush your DNS, just to be sure that your browsers use the new dns directives.
sudo dscacheutil -flushcache sudo killall -HUP mDNSResponder
- Open your
~/.lando/config.ymlfile and add the following line:
Again, allow your creativity to flourish and use whatever domain makes you smile.
- Power Lando down with
- Start up your favorite Lando app to test it out with
lando startfrom within your app's root directory. You should see something like:
BOOMSHAKALAKA!!! Your app has started up correctly. Here are some vitals: NAME bestappever LOCATION /Users/McFly/timemachines/bestappever SERVICES appserver, nginx, database, cache, node APPSERVER URLS https://localhost:32791 http://localhost:32792 http://bestappever.local.host https://bestappever.local.host
- Load it up in the browser and confirm everything is happy and working.
Enjoy your signature domain while you hack away in complete wifi-less splendor.