Lando What can it run?
How does it work?
1
Initialize a codebase for usage with Lando
This will create a starter Lando config file that you can then slowly augment with further dependencies as needed. You can initialize from code in a local folder or pull in code from a remote archive, git repo, GitHub or Pantheon!
Here are a few examples...
# Interactively initialize your code
lando init
# Set up a mean recipe that runs on a particular port with a particular command
lando init --source cwd \
--recipe mean \
--option port=3000 \
--option command="yarn watch" \
--name meanest-app-youve-ever-seen
# Interactively clone a site from Pantheon
lando init --source pantheon
# Spin up a new Drupal 7 site
lando init \
--source remote \
--remote-url https://ftp.drupal.org/files/projects/drupal-7.59.tar.gz \
--remote-options="--strip-components 1" \
--recipe drupal7 --webroot . \
--name hello-drupal7
2
Optionally customize for MOAR POWER
While our recipe defaults are plenty good for most use cases Lando let's you customize further. This means you can configure our recipes, add additional services, proxy routes, tooling commands, build steps, runtime automation, and Docker Compose overrides or do nothing at all!
Here is a progressively complexifying WordPress example...
Default WordPress recipe Landofile config
name: my-app
recipe: wordpress
Adding some basic recipe config
name: my-app
recipe: wordpress
config:
database: postgres
php: '7.3'
xdebug: true
Adding node tooling, solr, phpmyadmin and custom php config
name: my-app
recipe: wordpress
config:
database: postgres
php: '7.3'
xdebug: true
config:
php: my-custom-php.ini
proxy:
pma:
- database-my-app.lndo.site
services:
index:
type: solr
node:
type: node:10
globals:
gulp: latest
pma:
type: phpmyadmin
hosts:
- database
tooling:
yarn:
service: node
node:
service: node
Adding php extensions, build steps, automation, docker overrides
name: my-app
recipe: wordpress
config:
database: postgres
php: '7.3'
xdebug: true
config:
php: my-custom-php.ini
events:
post-db-import:
- appserver: wp search-replace
proxy:
pma:
- database-my-app.lndo.site
services:
appserver:
build_as_root:
- apt update -y && apt-get install vim -y
- /helpers/my-script-to-install-php-extension.sh memcached
build:
- composer install
overrides:
environment:
APP_LEVEL: dev
TAYLOR: swift
index:
type: solr
node:
type: node:10
globals:
gulp: latest
build:
- yarn
frontend:
type: node:10
command: yarn start
build:
- yarn
pma:
type: phpmyadmin
hosts:
- database
tooling:
yarn:
service: node
node:
service: node
gulp:
service: node
test:
cmd:
- appserver: composer test
- frontend: yarn test
deploy:
service: appserver
cmd: /path/to/script.sh
3
Try out some tooling commands
Lando isn't only about containerized services to run your application it also containerizes common dev tools like node, composer, drush, artisan and python. Try running lando after you start a project to see the tools available to your app, or add additional tooling.
Here are some commands for our complex WordPress config above.
# See what tools are available in your app
lando
# Run wp-cli commands
lando wp
# Drop into a postgres shell
lando psql
# Import a database
lando db-import dump.sql
# Run composer and yarn tests
lando test
# Install more node packages
lando yarn add bootstrap
# Start up gulp watch
lando gulp watch
4
Deploy and distribute
Once you are feeling good about your Landofile, commit it to your repository so other developers can easily get setup.
Project lead commits
# Commit and deploy
git add .lando.yml
git commit -m "Supercharge my dev"
git push
Other developers get
# Get the project
git clone my-project
cd my-project
# Start lando and get all the things you need
lando start
Wait... so who is using this again?
Lando is used by professional developers, leading digital agencies, universities and non-profits to make their dev better. It's also the engine that powers tools like Pantheon Localdev and is battle-tested by over
users and counting!
