Lando provides a stable, easy-to-use, and portable local development environment. It allows you to integrate phpMyAdmin (among other services) and simplifies setting up XDebug.
UserFrosting ships with a default landofile in
.lando.dist.yml, using the dist format. This enables conflict free overrides, which means you can overwrite this in your own project by creating a
.lando.yml landofile to customized it to your needs.
But for most people, the default configuration should be fine. With the included landofile, the following is supported;
bakerycommand exposed via Lando CLI.
redis-clicommand exposed via Lando CLI (haven't verified config here, I probably should).
phpunitcommand exposed via Lando CLI.
Start by installing Lando.
Once you've installed Lando, we can use UserFrosting built-in support for Lando to spin up a container with the appropriate configuration. In a directory of your choice, use git to clone the UserFrosting repository into a new directory :
git clone https://github.com/userfrosting/UserFrosting.git
cd into your new UserFrosting dir :
Using the terminal, run
lando start from within your UserFrosting app. The first start up will take a brief period to install everything and set up the docker components.
When the application boots successfully, you'll see something like:
___ __ __ __ __ ______ / _ )___ ___ __ _ ___ / / ___ _/ /_____ _/ /__ _/ /_____ _/ / / / / _ / _ \/ _ \/ ' \(_-</ _ \/ _ `/ '_/ _ `/ / _ `/ '_/ _ `/_/_/_/ /____/\___/\___/_/_/_/___/_//_/\_,_/_/\_\\_,_/_/\_,_/_/\_\\_,_(_|_|_) Your app has started up correctly. Here are some vitals: NAME userfrosting LOCATION /home/user/source/uf/framework SERVICES appserver, database, cache, pma, mh APPSERVER URLS https://localhost:49266 http://localhost:49267 http://userfrosting.lndo.site/ https://userfrosting.lndo.site/ PMA URLS http://localhost:49270 http://pma.userfrosting.lndo.site/ MH URLS http://localhost:49268 http://mh.userfrosting.lndo.site/
Next, we need to install UserFrosting.
lando composer installto install UserFrosting's PHP dependencies using Composer.
lando bakery baketo run UserFrosting's
bakecommand and follow the UserFrosting install steps, including the creation of your first admin user.
Now that you have your application running, you can access it at http://userfrosting.lndo.site or any other url displayed in
APPSERVER URLS from the previous steps.
Additional tooling and services can be accessed via;
lando bakery test