Networking

Lando sets up and manages its own internal Docker network. This provides a common pattern, predictable hostnames and a more reliable experience for local development networking, generally.

Specifically, every Lando service, even those added via the compose top level config, should be able to communicate with every other service regardless of whether that service is part of your app or not.

Also note that because of our automatic certificate and CA setup, you should be able to access all of these services over https without needing, for example the -k option in curl.

Cross app service communication requires all apps to be running!

If you want a service in App A to talk to a service in App B then you need to make sure you've started up both apps!

Automatic Hostnames

By default, every service will get and be accessible at a hostname of the form <service>.<app>.internal. For example, if you have an app called labouche and a service called redis, it should be accessible from any other container using redis.labouche.internal.

Lando will also look at your services proxy settings and alias those addresses to the correct service. This means that you should also be able to access services across apps using any of their proxy hostnames.

You can get information about which hostnames and urls map to what services using lando info.

Note that this automatic networking only happens INSIDE of the Docker daemon and not on your host.

Testing

You can verify that networking is set up correctly by spinning up two lamp recipes called lamp1 and lamp2 and running a few curl commands.

# Verify Lamp1's appserver can access Lamp2's appserver using the proxy and .internal addresses
cd /path/to/lamp1
lando ssh -s appserver -c "curl https://lamp2.lndo.site"
lando ssh -s appserver -c "curl https://appserver.lamp2.internal"

# And the reverse
cd /path/to/lamp2
lando ssh -s appserver -c "curl https://lamp1.lndo.site"
lando ssh -s appserver -c "curl https://appserver.lamp1.internal"

# You should even by able to connect to a database in a different app
cd /path/to/lamp2
lando ssh -s database -c "mysql -uroot -h database.lamp1.internal"

Accessing the host

As of Lando 3.22 you can now access your host from inside every Lando service using host.lando.internal

lando exec my-service -- ping host.lando.internal -c 3

You can also use the environment variable LANDO_HOST_IP.

lando exec my-service -- ping "\$LANDO_HOST_IP" -c 3

Network Limits

By default Docker has a limit of 32 networks. If you're running a large number of sites, you'll see a message Lando has detected you are at Docker's network limit, after which Lando will attempt to clean up unused networks to put you below the network limit.

If you've modified your Docker daemon to allow more networks, you can set Lando's network limit to a higher number by setting the networkLimit variable in Lando's global config.