Overriding a Service Version or Image

Written by: Team Lando

Updated 1 year ago

The Docker images Lando uses for services are well optimized for local development, but occasionally you need to override those images with some of your own secret sauce. Lando makes this easy to do through the services overrides key:

name: projectofdoom
recipe: drupal8
config:
  via: nginx
  webroot: web
  php: 7.3
  database: mariadb
  xdebug: true
env_file:
  - .env
services:
  database:
    overrides:
      image: bitnami/mariadb:10.3.27

In the example above, we're overriding the image to use an explicit release of Bitnami's MariaDB container to bypass a breaking change released on Bitnami's 10.3 tag (Lando's default version).

You can also use this to load your own custom images:

name: projectofdoom
recipe: drupal8
config:
  via: nginx
  webroot: web
  php: 7.3
  database: mariadb
  xdebug: true
env_file:
  - .env
services:
  appserver:
    overrides:
      image: myamazingorg/fancyappserver:latest