If you're not already familiar with Terminus, we suggest you read the Terminus Manual instead. This doc is specifically geared at existing Terminus users who need to update existing implementations.
Terminus 2.0 is the first major version release of Terminus in over two years. Following Semantic Versioning standards, this means there are updates in 2.0 that are incompatible with previous implementations. Before upgrading to Terminus 2.0, you should be aware of what changes could require updates to your scripting and implementation.
Do not upgrade production environments to Terminus 2.x without first testing in development and/or continuous integration environments.
These commands or their output have changed in a significant way that may affect your existing scripting of Terminus.
In the previous version of Terminus, the following commands would emit no output when returning empty results. As of Terminus 2.0, these commands will instead emit a warning when the output is empty:
The following commands now display progress bars while executing:
To omit the progress bar, scripts that use these commands can add the
-n flag for "non-interactive mode".
remote:wp now have the option to enable progress bars with the flag
service-level:set has been replaced with
plan:set. An example usage is:
terminus plan:set $SITE.$PLAN
In the example above,
$SITE can be set to the site name, and
$PLAN can be a plan SKU or UUID. Available plans are listed using
terminus plan:list $SITE.
The following commands are new to Terminus as of version 2.0:
plan:list: Requiring a site name or UUID as a value, this returns a list of plans available to that site.
plan:set: Requiring a site name or UUID and a plan name or SKU as values, this changes the named site to the plan size named.
The changes to these commands' behavior may affect existing integrations. For a complete list of all changes, see the Terminus changelog.
--ccto clear the cache, and
--updatedbto update the database (Drupal only).
payment-method:listnow emits a warning when empty. It previously emitted a notice-level log when empty.
plan_namefield being returned.