By default Lando runs a traefik reverse proxy when needed so that users' apps can route stable, predictable and "nice" URLS to various ports inside of various services.
While you can configure the default
domain of this proxy we highly recommend you do not alter the default behavior unless you have a fairly compelling reason to do so. A compelling reason to not change them are that the default
lndo.site domain works "out of the box" while custom domains require additional setup.
*.lndo.site is an actual ON THE INTERNET wildcard DNS entry that points all
*.lndo.site subdomains to
localhost/127.0.0.1. This means that if you lose your internet connection, you will not be able to visit your app at these addresses. However, you can take steps to work around this restriction or use your own custom domain and handle the DNS yourself with
dnsmasq or some other solution.
Proxying is not required
As long as your containers or services expose ports
443, Lando will smartly allocate
localhost addresses for them. Proxying is meant to augment how your app is accessed with additional domains.
There is also a known issue called DNS rebinding protection which blocks this functionality.
Automatic Port Assignment
By default Lando will attempt to bind the proxy to your host machines port
443. If it cannot bind to these addresses, which is usually the case if something else like a local
apache service is running it will fallback to other commonly used ports such as
444. The default and fallback ports Lando uses are all configurable.
If you want to use port
443 but cannot for the life of you figure out what is already using them you can do a bit of discovery using
lsof or by visiting
localhost in your browser and seeing if you recognize what loads.
# Find out if any service listens on those ports. sudo lsof -n -i :80 | grep LISTEN sudo lsof -n -i :443 | grep LISTEN # If any services are listed, you can try killing them or stopping them a different way. sudo kill -9 $PID
You can add routing to various services and their ports using the top-level
proxy config in your Landofile. Because our proxy also benefits from our automatic certificate and CA setup all proxy entries will automatically be available over both
Routing to port 80
web2 are the names of some of your services. If you are unsure about the names of your services run
proxy: web: - myapp.lndo.site web2: - admin-myapp.lndo.site
Routing to a different port
You can suffix the domain with
:PORT to change the default
PORT. Note that this is the port that your service exposes from within Lando and not an external port. In the below example this means that
appserver exposes port
8888 and we want
myapp.lndo.site to route our request into Lando at
proxy: appserver: - myapp.lndo.site:8888
Using a non
You can actually use any domain in your proxy settings but you will be responsible for their DNS resolution and any relevant cert handling. See the configuration section below for more details.
If your custom domain does not end in
lndo.site and you unsure about how to handle DNS resolution using something like DNSMasq then you are going to need to add it to your
hosts file so that it points to
proxy: web: - mysite.lndo.site - sub.mysite.lndo.site - bob.frank.kbox.com - tippecanoe.tyler.too
If a service is able to listen to multiple domain names following a common pattern you can use the
* wildcard character to match any amount of alphanumeric characters and hyphens/dashes (
site2.myapp.lndo.site you can for example use
Wildcard domains need to be encapsulated in quotations
If you are using a wildcard domain you will need to write it as
"*.myapp.lndo.site" and not
*.myapp.lndo.site due to the way
yaml parses files. If you do not do this you should expect a
yaml parse error.
proxy: web2: - another.lndo.site - "*.mysite.lndo.site" - "orthis.*.lndo.site"
While you can sub-sub-...-sub-subdomain to your hearts content we recommend you do not because the Lando CA only handles first level subdomains by default. This will cause sub-subdomains or deeper to produce browser warnings even if you have trusted our CA. We recommend you instead use hypenated "subdomains"
Works but not recommended
proxy: web2: - admin.mysite.lndo.site - better.admin.mysite.lndo.site - mailhog.mysite.lndo.site - pma.mysite.lndo.site
Works AND recommended!
proxy: web2: - admin-mysite.lndo.site - better-admin-mysite.lndo.site - mailhog-mysite.lndo.site - pma-mysite.lndo.site
You can read more about this restriction here.
Various parts of the proxy are configurable via the Lando global config.
Again, you REALLY REALLY REALLY should not change these settings unless you have a good reason and know what you are doing!
# Set to anything else to disable proxy: ON # Legacy, use the "domain" setting below instead proxyDomain: lndo.site proxyHttpPort: 80 proxyHttpsPort: 443 proxyHttpFallbacks: - 8000 - 8080 - 8888 - 8008 proxyHttpsFallbacks: - 444 - 4433 - 4444 - 4443 # Editing the domain will also generate a new Lando CA # See the Security docs for more info on that domain: lndo.site
You will need to do a
lando poweroff to apply these changes.
Note that we generate a Certificate Authority based on the
domain and use this CA to sign wildcard certs for each service. This means that we are inherently bound to certain restrictions governing wildcard certificates. For example if you set
domain to a top level domain such as
test you should not expect our wildcard certs to work correctly. It is recommended you use a first level subdomain such as
Working Offline or Using Custom Domains
If you are working offline and/or have added custom domains and want to get them to work, you will need to edit your
hosts file. Generally, this file is located at
/etc/hosts on Linux and macOS and
C:\Windows\System32\Drivers\etc\host on Windows. You will need administrative privileges to edit this file.
Here is a good read if you are not very familiar with the
hosts file, how to edit it and how it works.
Here is an example:
# Get my `lndo.site` domain to work offline 127.0.0.1 myapp.lndo.site # Get my custom domain to work 127.0.0.1 billy.dee.williams
For a more comprehensive doc on this please check out our Working Offline Guide.