Stay up to date on the latest Terminus version.
The recent 2.x releases of Terminus signify a major version upgrade, which may not be backwards-compatible with scripts written for Terminus 1.x. For more information, see Terminus 2.0.
Navigate to the directory where Terminus was originally installed, then run:
curl -O https://raw.githubusercontent.com/pantheon-systems/terminus-installer/master/builds/installer.phar && php installer.phar updateTerminus uses Semantic versioning. Be sure to fully test compatibility with existing configurations before upgrading to new major releases.
If the update command above returns output indicating that no updates were found, delete the existing Terminus version (e.g. \$HOME/terminus) and re-run the install command:
rm -rf $HOME/terminus mkdir $HOME/terminus cd $HOME/terminus curl -O
https://raw.githubusercontent.com/pantheon-systems/terminus-installer/master/builds/installer.phar
php installer.phar installEach major and minor version of Terminus is fully supported for one year from the release of the subsequent version. During the supported period, serious bugs and security issues that have been reported are fixed in patch releases. See Semantic Versioning for more information on versioning.
After this period, the version will reach End Of Life (EOL), and will no longer be supported. We strongly encourage you to update Terminus well ahead of the EOL schedule, so that regressions in new versions can be reported and patched in time.
| Version | EOL Date |
|---|---|
| 2.4.0 | TBD |
| 2.3.0 | 6/20/2021 |
| 2.2.0 | 1/11/2021 |
| 2.1.0 | 9/26/2020 |
| 2.0.0 | 9/03/2020 |
| 1.9.0 | 2/20/2020 |
| 1.8.1 | 9/11/2019 |
| 1.8.0 or earlier | 8/26/2019 |
--no-db added to multidev:create which will skip the duplication of the database from the source environment. (#2050)--no-files added to multidev:create which will skip the duplication of files from the source environment. (#2050)no-db added to Environments::create which will skip the duplication of the database from the source environment. (#2050)no-files added to Environments::create which will skip the duplication of files from the source environment. (#2050)Upstream::hasCode() returns a bool indicating whether the environment has code or not. (#2056)Request::download($url, $target) now accepts directories in addition to files as its $target parameter. (#2053)backup:get command's --to option now accepts directories in addition to files. (#2053)Redis::disable() has changed to a Workflow model. (#2055)Redis::enable() has changed to a Workflow model. (#2055)Solr::disable() has changed to a Workflow model. (#2055)Solr::enable() has changed to a Workflow model. (#2055)Environment::disableHttpsCertificate() has changed to a Workflow model. (#2055)Backup::serializeWithURL() function. Use Backup::serialize() instead. (#2042)Environment::convergeBindings() method. (#2055)Site::converge() method. (#2055)upstream:updates:status on an environment without code. (#2056)UpstreamStatus::hasUpdates() on an environment without code. (#2056)TERMINUS_HOST_CERT added to permit use of SSL certificates while making requests. (#2024)Hook.php in addition to those ending with Command.php (#2025)org:people:add is now being validated before sending the request. (#2033)org:people:role is now being validated before attempting the change. (#2033)site:team:add is now being validated before attempting the change. (#2033)site:team:role is now being validated before attempting the change. (#2033)--cc option on env:deploy. Please use env:clear-cache instead. (#2022)primary field to the output of domain:list. (#2011)domain:primary:add command to set a domain as primary, causing traffic to redirect to it. (#2011)domain:primary:remove command to remove a domain's primary designation. (#2011)--filter option to backup:list command (#1992)--filter option to branch:list command (#1992)--filter option to domain:list command (#1992)--filter option to env:list command (#1992)--filter option to multidev:list command (#1992)--filter option to org:list command (#1992)--filter option to org:people:list command (#1992)--filter option to org:site:list command (#1992)--filter option to org:upstream:list command (#1992)--filter option to payment-method:list command (#1992)--filter option to plan:list command (#1992)--filter option to site:list command (#1992)--filter option to site:org:list command (#1992)--filter option to site:team:list command (#1992)--filter option to ssh-key:list command (#1992)--filter option to upstream:list command (#1992)--filter option to upstream:updates:list command (#1992)backup:list --element=VALUE option is deprecated. Use --filter="type=VALUE" instead. (#1992)site:list --framework=VALUE option is deprecated. Use --filter="framework=VALUE" instead. (#1992)site:list --name=VALUE option is deprecated. Use --filter="name=VALUE" instead. (#1992) site:list --plan=VALUE option is deprecated. Use --filter="plan_name=VALUE" instead. (#1992) org:site:list --plan=VALUE option is deprecated. Use --filter="plan_name=VALUE" instead. (#1992)org:site:list --tags=VALUE option is deprecated. Use --filter="tags=VALUE" instead. (#1992)org:upstream:list --framework=VALUE option is deprecated. Use --filter="framework=VALUE" instead. (#1992)org:upstream:list --name=VALUE option is deprecated. Use --filter="label=VALUE" instead. (#1992) upstream:list --framework=VALUE option is deprecated. Use --filter="framework=VALUE" instead. (#1992)upstream:list --name=VALUE option is deprecated. Use --filter="label=VALUE" instead. (#1992) drush:aliases now produces both Drush 8 and Drush 9 aliases. Wildcard alias records always used (requires Drush 8.3.0 or later). (#1994)site:info's value of the region field has been changed to use human-readable region names. (#1985)site:list's value of the region field has been changed to use human-readable region names. (#1985)owner:set instead of the user's first and last names. (#2007)site:team:list. (#2007)org:people:list. (#2007)site:org:list so that it no longer ends without returning anything. (#1964)env:deploy so the --note option is used when initializing the test or live environments. (#1965)env:deploy when initializing the test or live environments. (#1965)plan:list command lists the plans available to a site. (#1901)plan:set command sets a site's plan. (#1901)Plans collection interacts with plans available to a Site. (#1901)Plan model represents a plan available to a Site or set on a site. (#1901)Site::getPlan() function to retrieve a model representing the Site's present plan. (#1901)Site::getPlans() function to retrieve a collection representing all available plans for the Site. (#1901)backup:list now emits a warning when its list is empty. (#1906)branch:list now emits a warning when its list is empty. (#1906)domain:list now emits a warning when its list is empty. (#1906)env:list now emits a warning when its list is empty. (#1906)plan:list now emits a warning when its list is empty. (#1906)site:team:list now emits a warning when its list is empty. (#1906)upstream:list now emits a warning when its list is empty. (#1906)backup:restore. (#1907)connection:set. (#1907)env:clear-cache. (#1907)env:clone-content. (#1907)env:commit. (#1907)env:deploy. (#1907)env:wipe. (#1907)https:remove. (#1907)https:set. (#1907)import:complete. (#1907)import:database. (#1907)import:files. (#1907)import:site. (#1907)lock:disable. (#1907)lock:enable. (#1907)multidev:create. (#1907)multidev:delete. (#1907)multidev:merge-from-dev. (#1907)multidev:merge-to-dev. (#1907)new-relic:disable. (#1907)new-relic:enable. (#1907)org:people:add. (#1907)org:people:remove. (#1907)org:people:role. (#1907)org:site:remove. (#1907)owner:set. (#1907)payment-method:add. (#1907)payment-method:remove. (#1907)plan:set. (#1907)redis:disable. (#1907)redis:enable. (#1907)service-level:set. (#1907)site:create. (#1907)site:org:add. (#1907)site:org:remove. (#1907)site:team:add. (#1907)site:team:remove. (#1907)site:team:role. (#1907)site:upstream:clear-cache. (#1907)site:upstream:set. (#1907)solr:disable. (#1907)solr:enable. (#1907)upstream:updates:apply. (#1907)TERMINUS_TIMEOUT added to extend the timeout maximum for remote commands. (#1908)remote:drush. (#1910)remote:wp. (#1910)site:delete. (#1922)site:create. (#1932)Environment::cloneDatabase accepting clear_cache and updatedb. (#1940)env:clone-content accepting cc and updatedb both defaulting to false. (#1940)--plan option to site:list to filter the site list by plan name. (#1944)--plan option to org:site:list to filter the organizational site list by plan name. (#1944)Sites::filterByPlanName(string) function to filter the site models by their plan_name attribute. (#1944)Environment::hasUncommittedChanges() to determine whether SFTP-mode environments have changes which have not been committed. (#1948)--upstream option to site:list to filter the site list by their upstream UUID. (#1946)--upstream option to org:site:list to filter the organizational site list by their upstream UUID. (#1946)Sites::filterByUpstream(string) function to filter the site models by their product_id attribute. (#1946)is_owner field to the output of site:team:list in order to indicate which user is the site owner. (#1949)is_owner field to the output of SiteUserMemberships::serialize() in order to indicate which user is the site owner. (#1949)SiteUserMemberships::isOwner() function in order to ascertain whether the user is the site's owner. (#1949)--progress option has been added to remote:drush and remote:wp to enable progress for remote commands. (#1947)org:site:list now displays a Plan/plan_name field to replace Service Level/service_level. (#1901)site:info now displays a Plan/plan_name field to replace Service Level/service_level. (#1901)site:list now displays a Plan/plan_name field to replace Service Level/service_level. (#1901)$pretty_name static property has become const PRETTY_NAME. (#1906)org:people:list has become a warning. (#1906)org:site:list has become a warning. (#1906)payment-method:list has become a warning. (#1906)site:list has become a warning. (#1906)site:org:list has become a warning. (#1906)sendCommandViaSsh function from Environment to SSHBaseCommand. (#1910)useTty function from SSHBaseCommand to LocalMachineHelper. (#1910)site:delete now uses a workflow. (#1922)Site::delete() now returns a Workflow object. (#1922)upstream:updates:list now orders the pending updates in chronological order. (#1852)started_at data returned by workflow:list is now formatted using TERMINUS_DATE_FORMAT. (#1923)finished_at data returned by workflow:list is now formatted using TERMINUS_DATE_FORMAT. (#1923)Pantheon\Terminus\Friends\RowsOfFieldsTrait has become Pantheon\Terminus\Commands\StructuredDataTrait. (#1923)Backup::getUrl() has been changed to Backup::getArchiveURL(). (#1923)env:clone-content is now checked for initialization prior to cloning. (#1930)accounts/site-account-forwarding/{site_id}/plans. (#1936)connection:set will emit a warning if you are attempting to switch out of SFTP mode while the environment has uncommitted changes. (#1948)connection:set will ask for confirmation before switching out of SFTP mode with uncommitted changes as it destroys those changes. (#1948)connection:set will emit an error if the requested mode is invalid. (#1948)Environment::changeConnectionMode(string) never returns a string, only a Workflow. (#1948)Environment::changeConnectionMode(string) will throw a TerminusException if the mode is neither "git" nor "sftp". (#1948)Environment::changeConnectionMode(string) will throw a TerminusException if the requested mode is the current one. (#1948)upstream:updates:status now litanizes the possible results. (#1951)service-level:set is now deprecated. Please use plan:set. (#1901)Site::updateServiceLevel() is now deprecated. Please use Plans::set(). (#1901)Environment::importDatabase() by switching from using the import_database workflow to do_import. (#1909)Environment::importFiles() by switching from using the import_files workflow to do_import. (#1909)import:database by switching from using the import_database workflow to do_import. (#1909)import:files by switching from using the import_files workflow to do_import. (#1909)site:upstream:set to appropriately reject attempted changes by unauthorized users. (#1913)site:team:remove when removing oneself from the team an error is no longer thrown upon success. (#1914)TERMINUS_ENV environment var. (#1917)TERMINUS_SITE environment var. (#1917)upstream:updates:apply. (#1851)TerminusConfig::fromArray(). Use the inherited TerminusConfig::combine(). (#1923)TerminusConfig::toArray(). Use the inherited TerminusConfig::export(). (#1923)Pantheon\Terminus\Friends\RowsOfFieldsInterface (#1923)Workflow::wait (#1937)Workflow::POLLING_PERIOD. Please use TERMINUS_HTTP_RETRY_DELAY_MS (#1937)php_version/PHP Version info from the result of site:info. (#1952)php_version property from the hash returned by `Site::serialize(). (#1952)Site::getPHPVersion(). It is preferable to use Environment::getPHPVersion() for more accurate info. (#1952)hide_git_mode_warning option to disable the warning presented when users run Drush or WP-CLI commands on Pantheon sites that are in git mode. (#1882)dev components named in their composer.lock file that have not been installed. (#1880)alpha:env:metrics command has been added. (#1835)workflow:watch command by preventing cached data from being pulled. (#1827)last_frozen_at field to the output of site:info and the Site::serialize() function. (#1788)This should've been tagged 1.7.0.
last_frozen_at field to the output of site:info and the Site::serialize() function. (#1788)domain:dns has returns a new field, detected_value, which indicates the live DNS settings for a given domain. (#1756)domain:dns has returns a new field, status, which indicates whether live DNS settings for a given domain match the recommended setting. (#1756)site:upstream:clear-cache to clear code caches on a site. (#1762)TerminusCollection::reset() to reset the model array (after filtering or sorting). (#1779)domain:dns. (#1756)Domains::setHydration(string) function. (#1756)TerminusCollection::listing(string, string). (#1779)Loadbalancer model. (#1779)Loadbalancers collection. (#1779)multidev:create is now checked for whether the site is frozen before attempting to execute. (#1761)import:database is now checked for whether the site is frozen before attempting to execute. (#1761)domain:list now lists id, type, and deleteable attributes. (#1763)https:info now lists id, type, status, status_message, and deleteable attributes. (#1763)https:info emits a RowsOfFields object instead of a PropertyList. (#1763)domain:dns now emits an info log instead of a warning. (#1772)TerminusCollection::fetch() no longer accepts an array of options. Use setData(array) to pass in data and setFetchArgs(array) for the same functionality. (#1779)Workflow:operations() is deprecated. Use the Workflow::getOperations() to retrieve workflow operations. (#1769)longname field output by upstream:list to label. (#1747)longname field output by upstream:info to label. (#1747)core and custom are the only ones which appear by default when using upstream:list. (#1747)--org option of the site:list command now defaults to "all" instead of null, but its behavior is unchanged. (#1747)role parameter of the site:team:add command defaults to team_member. (#1750)machine_name field to the output of upstream:list. (#1747)organization field to the output of upstream:list. (#1747)machine_name field to the output of upstream:info. (#1747)organization field to the output of upstream:info. (#1747)repository_url field to the output of upstream:info. (#1747)org:upstream:list command to list the upstreams of a specific organization. (#1747)--org option to upstream:list to list the upstreams of a specific organization. (#1747)--all option to list upstreams of all types in the output of upstream:list. (#1747)--framework option to upstream:list to filter the list by framework. (#1747)--name option to upstream:list to filter the list by name regex. (#1747)category field from the output of upsteram:info. (#1747)org option of site:create now works with machine names and labels as well as UUIDs. (#1747)change_management feature is not enabled on a site, no warning is displayed only if the role has been supplied and is not team_member. (#1750)import:site/site:import to call the params params rather than options. (#1718)frozen column to the output of org:site:list. (#1726)backup:get, changed its default to "files". (#1705)site:upstream:set command to switch a site's upstream. (#1713)env:commit now has a --force option to force a commit even if no changes are found. (#1115)UpdateChecker. (#1687)Backup::getDate() now returns a Unix datetime instead of a formatted date. (#1676)backup:info command has been added. (#1676)backup:list. (#1676)Backup::getExpiry() calculates the Unix datetime of a backup's expiry. (#1676)env:commit and env:diffstat help description. (#1685)self:console command in PHP 7.1. (#1664)aliases command which prevented the authorization hook from working on it. (#1663)bin property set to include bin/terminus. (#1656)--element= option to backup:list. (#1563)org:list's output. (#1612)upstream:updates:status command to report whether any site environment is outdated or current. (#1654)self:cc now acts to delete all files in the command cache directory. (#1569)env:clone-content and env:deploy now refuse to clone from uninitialized environments. (#1608)name in org:list's output now contains the machine name of an organization. (#1612)organization parameter or org option now accepts an organization's UUID, name, and label. (#1612)SiteOrganizationMemberships::create($org, $role) is now an Organization object. (#1612)element parameter on backup:list is deprecated. Use the --element= option instead. (#1563)wait() function of Workflows is deprecated. Use checkStatus() instead. (#1584)User::getOrgMemberships() is deprecated. Use User::getOrganizationMemberships() instead. (#1613)new-relic:info by changing NewRelic::serialize() to fetch its data before attempting to return it. (#1648)