Lando is for developers who want to:
- Quickly specify and painlessly spin up the services and tooling needed to develop their projects.
- Ship these local development dependencies in a per-project, lives-in-git config file
- Automate complex build steps, testing setups, deployments or other repeated-more-than-once workflows
- Avoid the built-in-masochism of directly using
It's a free, open source, cross-platform, local development environment and DevOps tool built on Docker container technology and developed by Tandem. Designed to work with most major languages, frameworks and services, Lando provides an easy way for developers of all skill levels to specify simple or complex requirements for their projects, and then quickly get to work on them.
Think of it as your local development dependency management and automation tool.
What is it good for?
- Mimicking your production environment locally
- Standardizing your teams dev environments and tooling on OSX, Windows and Linux
- Integrating with hosting providers like Pantheon
- Customizing or extending tooling, deployment options and basically any other functionality
- Running CI tests locally, running local tests in CI
- Using a single local development environment for all your projects
- Freeing yourself from the tyranny of inferior local development products
Wait, doesn't Docker Compose do this?
Yes! Well, sort of. You can think of Lando as both an abstraction layer and superset of Docker Compose as well as a Docker Compose utility.
As an abtraction layer Lando vastly reduces the complexity of spinning up containers by exposing only the most relevant config for a given "service" and setting "sane defaults". Lando also provides "recipes" which are common combinations of services and their tooling that satisfy a given development use case eg Drupal, Python, Laravel, Dotnet, etc.
As a superset Lando provides ways for developers to run complex commands, build steps and automation on their services without the hassle of custom Dockerfiles or long "docker exec" commands. Think
lando yarn add express. Think clear my applications cache after I import a database. Think install this
php-extension before my appserver starts and then
composer install after it does.
As a utility Lando handles some of the more arduous setup required for a good Docker Compose setup eg proxying, nice urls, cross-application networking (think Vue.js frontend talking to separate Laravel backend), host-container file permission handling, file sharing, per-container SSL certificate handling, ssh-key handling, etc.
And! If you don't like the default choices we've made all of the above is highly configurable down to the Docker Compose level itself!
Begin by checking out
Then try out one of our preconfigured recipe start states
Or build up from a base language
And then mix in additional auxiliary services
And then dive deep into reference materials
- SSH Keys
- Shared Files
- Global Config
And then check out some helpful guides
- Updating your Landofiles to 3.0.0-rc.2+
- Accessing Your Services Externally
- Accessing Lando from Other Devices
- Exporting Databases
- Importing Databases
- Killer D8 Workflow with Platform.sh
- Lando + PhpStorm + Xdebug
- Offline Development
- Using $LANDO_INFO
- Using NodeJS Frontend Tooling
- Using Lando in Visual Studio Code
- Climbing a mountain for love
And the known issues
- DNS Rebinding Protection
- File Uploads on Windows
- File Syncing Stalled
- Running VB and HyperV
- Running behind a proxy
- Switching Database Config
You can also get some troubleshooting and support
Or learn how to contribute
And finally check out some helpful and tested-on-every-build examples
If you have discovered a security issue with Lando, please contact the Lando Security Team directly at firstname.lastname@example.org. We manage security issues separately in a private repository until the issue has been resolved. Even if you're not sure if it's a security problem, please contact the security team before filing an issue, blogging, or tweeting about it.