This is the official Lando plugin for Upsun (formerly Platform.sh). When installed it...
- Runs Upsun Flex (
.upsun/config.yaml) and Upsun Fixed (.platform.app.yaml+.platform/) projects, including Adobe Commerce Cloud - Builds the applications and services in your Upsun config (unsupported types produce a warning), with the same
PLATFORM_*variables and relationships your app gets on Upsun - Runs your mounts, hooks and workers, and your crons when
config.cronsis enabled - Serves your routes and redirects on local
*.lndo.siteURLs and catches outgoing mail with Mailpit - Pulls and pushes databases and files with
lando pullandlando push(not available for Adobe Commerce Cloud projects) - Adds the Upsun CLI (
upsun, orplatformfor Fixed projects),lando db-import/lando db-export, and Xdebug toggles
Of course, once you're running your Upsun project with Lando you can take advantage of all the other awesome development features Lando provides.
Add a Landofile next to your .upsun/ or .platform/ directory:
name: my-project
recipe: upsunThen start the app and grab your data:
lando start
lando pullStarting from a project that only exists on Upsun? lando init --source upsun (Flex) or lando init --source platformsh (Fixed) clones it and writes the Landofile for you.
For more info you should check out the docs:
lando plugin-add @lando/upsunIf you have a question or would like some community support we recommend you join us on Slack.
If you'd like to report a bug or submit a feature request then please use the issue queue in this repo.
We try to log all changes big and small in both THE CHANGELOG and the release notes.
- Requires Node 20+
git clone https://github.com/lando/upsun.git && cd upsun
npm installSee Development and Architecture for how the plugin is put together.
# Lint the code
npm run lint
# Lint, typecheck and run the unit tests
npm test
# Run the Leia tests in examples/ (needs Docker)
npm run test:leiaPublish a GitHub release. The release workflow publishes it to npm, and prereleases go out under the edge tag.