The Locomotive V4 Developer Hub

Welcome to the Locomotive V4 developer hub. You'll find comprehensive guides and documentation to help you start working with Locomotive V4 as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Deploy a site

Once you have a working Wagon site, you probably want to see it working online, with the back-office and everything. That's the role of the Locomotive engine.


The only requirement is to have somewhere (it can be online or locally) a running engine and an account. Check out the engine installation guide for more information.


wagon deploy ENV [PATH]

ENV references the name of your target platform in your config/deploy.yml file.

If the target doesn't exist, the deploy command will ask you for the information about the platform you want to deploy your site to. Then, it will create the site on the Locomotive engine and will update your config/deploy.yml accordingly.


You can have as many targets (test, …etc) as you want.

In some cases, you do not want to push the whole site. For instance, if you have just modified a single page, you do not need to push the assets too.

The available resource types are: theme_assets, content_types, content_entries, snippets, pages and site.


-r one, [--resources=one two three]Only push the resource(s) passed in argument
-d, [--data], [--no-data]Push the content entries, the editable elements and the translations (by default, they are not)
-v, [--verbose], [--no-verbose]Show each resource being deployed. Display the full error stack trace if an error occurs.
-f filename, [--filter=filename]Filter the resource(s) to be deployed by its name plus extension. It can be used in conjunction with '-r' option to control exactly what is been pushed.


  host: station.locomotive.works
  handle: my-site-staging
  email: [email protected]
  api_key: 373e4330e47d30456221caa4e6b174428b9a1de

  host: station.locomotive.works
  handle: my-site-live
  email: [email protected]
  api_key: 373e4330e47d30456221caa4e6b174428b9a1de
wagon deploy staging
wagon deploy live -r pages -v
wagon deploy live -r content_types content_entries -d

Updated 3 months ago

Deploy a site

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.