Getting Started

Requirements

Before you get started with this recipe we assume that you have:

  1. Installed Landoopen in new window and gotten familiar with its basicsopen in new window
  2. Initializedopen in new window a Landofileopen in new window for your codebase for use with this recipe
  3. Read about the various servicesopen in new window, toolingopen in new window, eventsopen in new window and routingopen in new window Lando offers.

Quick Start

Try out the relevant commands below to spin up a new Landoified vanilla LEMP site.

Note that CodeIgniter could be any other php frameworkopen in new window or your own custom php thing.

# Initialize a lemp recipe using the latest codeigniter version
lando init \
  --source remote \
  --remote-url https://github.com/bcit-ci/CodeIgniter/archive/3.1.10.tar.gz \
  --remote-options="--strip-components 1" \
  --recipe lemp \
  --webroot . \
  --name my-first-lemp-app

# Start it up
lando start

# List information about this app.
lando info

Custom Installation

This plugin is included with Lando by default. That means if you have Lando version 3.0.8 or higher then this plugin is already installed!

However if you would like to manually install the plugin, update it to the bleeding edge or install a particular version then use the below. Note that this installation method requires Lando 3.5.0+.

# Ensure you have a global plugins directory
mkdir -p ~/.lando/plugins

# Install plugin
# NOTE: Modify the "yarn add @lando/lemp" line to install a particular version eg
# yarn add @lando/lemp@0.5.2
docker run --rm -it -v ${HOME}/.lando/plugins:/plugins -w /tmp node:14-alpine sh -c \
  "yarn init -y \
  && yarn add @lando/lemp --production --flat --no-default-rc --no-lockfile --link-duplicates \
  && yarn install --production --cwd /tmp/node_modules/@lando/lemp \
  && mkdir -p /plugins/@lando \
  && mv --force /tmp/node_modules/@lando/lemp /plugins/@lando/lemp"

# Rebuild the plugin cache
lando --clear
# @TODO
# @NOTE: This doesn't actaully work yet
hyperdrive install @lando/lemp

You should be able to verify the plugin is installed by running lando config --path plugins and checking for @lando/lemp. This command will also show you where the plugin is being loaded from.