pantheon-systems/terminus
Stars: 298
Forks: 189
Pull Requests: 1522
Issues: 973
Watchers: 83
Last Updated: 2023-09-14 13:36:29
The Pantheon CLI — a standalone utility for performing operations on the Pantheon Platform
License: Other
Languages: PHP, Shell, Gherkin, Twig, Ruby, Makefile
terminus : Pantheon's Command-Line Interface
Status
About
Terminus is Pantheon's Command Line Interface (CLI), providing at least equivalent functionality to the Pantheon's browser-based Dashboard and easier scripting.
If you would like to contribute, pull requests are welcome!
The Manual
Our documentation is kept in the Terminus Manual, located here: https://pantheon.io/docs/terminus
Requirements
| Operating System | Version |
|---|---|
| MacOS | 10.14+ |
| Ubuntu | Latest LTS |
| Windows + WSL + Ubuntu | TBD |
Package Manager
Required Packages
These packages are required to take full advantage of Terminus.
-
Composer 2 (Needed for the plugin manager component)
-
PHP (v7.4+)
-
Git (May be needed for the plugin manager component)
Recommended Packages
-
Drush (Useful to run incompatible-with-Terminus Drush commands)
-
WP-CLI (Useful to run incompatible-with-Terminus WP-CLI commands)
Installation
Mac OS:
Terminus is published as a package under pantheon-systems/external. To install it, you should run:
brew install pantheon-systems/external/terminus
Ubuntu / WinWSL+Ubuntu:
*** TBD ***
Other installation methods
Refer to the Terminus manual for other installation methods.
OPEN ISSUES
See all- Throw error when invalid SSH key is provided by @danielbachhuber
- Automate downloading logs from servers by @nstielau
- Add database piping tool by @wmcmillian-coalmarch
- Add support for kill-queries command to kill long running transactions in mysql by @timani
- Feature request: terminus self:update by @dearmond
- Change sites import to accept local files by @ioskevich
- SSH Tunnel by @dalin-
- Start token generation workflow from the CLI by @joshkoenig
- `terminus sites create` API call crashes with a Python backtrace by @ossobuffo
- Add a terminus command to check env binding ID by @rubelyn
- Terminus doesn't detect changes to dev/multidev environment when env is in SFTP mode by @danielbachhuber
- drush updatestatus not found by @tributemedia
- Expose replica/slave DB connection info by @iamEAP
- Cannot apply available updates with Terminus by @chrisgross
- terminus site deploy should exit with a non-zero status if deploy fails by @bwood
- terminus --help UX improvement ideas by @bwood
- Win10/Cygwin Installation by @WardinT
- Feature Request 'terminus site:list --member' by @bwood
- mass-update fails by @tributemedia
- Ignore Dot Directories in ~/terminus/plugins by @derimagia
- Issue closed with no explanation by @brookemahoney
- Terminus should use my last-used session to log me back in by @TeslaDethray
- posix_isatty() is not available in Windows Environments by @joshkoenig
- Terminus could throw an error when old-style wp-cli / drush parameter quoting is used. by @danielbachhuber
- Need terminus to allow plugin updates for multiple sites with one command by @FRNetwork
- Add "processing" output to potentially long-running commands by @iamEAP
- Bug when applying site updates by @settermjd
- Plugin's commands detection does not work when multiple directories are used for the same prefix by @pbuyle
- Pipe Terminus output to log by @danielbachhuber
- Terminus autocomplete by @greg-1-anderson
- Feature request: Support zero-conf by @dbuch
- Turning down the error reporting for automated scripts by @dalin-
- WordPress Update Data is wrong for Production by @grok
- Add backup:delete command by @thomas-thackery
- Can't run terminus aliases after installing 1.1.1 by @rjh123
- Error with Drush by @danheisel
- Terminus operation failed to complete by @ttrowell
- Running Terminus programmatically from node fails. by @generalredneck
- Terminus command to unfreeze a site by @giteshk
- terminus site:create fails with timeout by @ioskevich
- Can't perform http:// to https:// search-replace with terminus wp command? by @ghost
- `terminus whoami` no longer exits with return code 1 when unauthenticated by @danielbachhuber
- Allow viewing and filtering by upstream in site:list by @guyoron
- Allow Terminus to specify `-o StrictHostKeyChecking=no` on `wp` or `drush` commands to help automation by @joshkoenig
- Version v1.4.0 does not return output from remote:wp command when --quiet parameter is supplied by @tlb420
- Terminus needs option to output "working ..." text to cli on slow running commands by @finteractive
- Plugin installation workflow by @greg-1-anderson
- env:deploy command not clearing cache or running database updates. by @chrisgross
- Notices on every wpcli command, even when successful by @ataylorme
- Download drush alias for single sites by @arrubiu
- Cannot upgrade using command line instructions by @ghost
- Feature Request: plugin:info command by @alisonjo315
- Terminus can break WXR imports using WordPress importer by @danielbachhuber
- Support for Multiple Values for TAG? by @populist
- PHP Fatal error: Terminus has colliding constructor definitions -- PHP 5.5.9 by @rubelyn
- `getCommits()` function error when running env:deploy by @tdmalone
- Having trouble getting output on Windows by @tdmalone
- env:diffstat & env:commit are unaware of SFTP changes by @philmprice
- Command to check if code updates available for deploy to test, live by @guyoron
- --field= option for RowsOfFields-returning commands prevents --format= from working by @bwood
- Feature Request: Terminus Audit Command by @ghost
- Is it possible to chain WP CLI commands together? by @jaredcobb
- Notice: A New Version of Terminus is Available but I Already Have the Newest Version by @digisavvy
- Errors incorrectly reported from terminus env:merge-from-dev when there are conflicts by @greg-1-anderson
- Add an IS_MULTIDEV type variable by @retrodans
- Invalid behaviour in Sites::filterByTag() when sites have no tags by @nterbogt
- Support for easier plugin maintenance by @nterbogt
- Error of "[preflight] Unable to parse at line 2 (near "<?php")." when trying to run remote:drush commands by @alphex
- terminus drush site-install throws mysql error by @calmher
- Feature Request: Include upstream ID & upstream name as fields in site:list by @SteveRyan-ASU
- 403 forbidden when setting upstream, needs better error message by @ElijahLynn
- terminus upstream:updates:apply stuck in infinite loop following parse error in wp-config by @pwtyler
- Terminus doesn't output results of remote commands by @peterromero
- terminus site:info reports the wrong PHP version by @bwood
- Add homebrew back by @wturnerharris
- error: "continue" targeting switch is equivalent to "break" by @cjokinen
- Commands tergeting remote servers never execute in WSL by @jlandrum
- Running remote:wp fails to generate output for interactive terminal by @westonruter
- AL-1691: Not able to capture remote command output by @kxwang
- terminus wp cli media import not working if using wildcard for filenames by @carl-alberto
- WP CLI alias by @killua99
- Intermittent "Broken pipe (32)" error when running sql-sync (Lando) by @amaisano
- Intermittent, various "rsync: read error" issues when pulling files by @amaisano
- When updating from 1.x to 2.0 -- suggestion to provide better directions on how to upgrade terminus by @alphex
- site:org:list: Fails to return a list of supporting organizations by @bwood
- Backing up the database only reports that everything is backed up by @dalin-
- env:commit is finishing/exiting too soon by @jfussion
- Feature request - Open Social upstream for Drupal 8 using Terminus by @jmcausing
- Add 'label' to output of site:list and org:site:list by @vinmassaro
- terminus plan:* doesn't seem to work right by @cweagans
- Cannot search text in terminal window by @hollydragon
- Error Running upstream:updates:status by @dirtystylus
- Using terminus to spin up a new site doesn't have option for creating private Github repo by @trittgers-principal
- [BUG] plan:info returns error: Notice: Trying to get property of non-object by @thomas-thackery
- [Feature Request] Add option to backup:create to run in background by @asentner
- Cannot access the site by @ugintl
- Terminus does not install on a drupal-composer/drupal-project project by @mherchel
- Filter option usage and help text unclear by @ataylorme
- update-class-lists drops Consolidation\\Filter\\Hooks\\FilterHooks by @mbaynton
- environment variables aren't properly expanding to override nested configuration options by @ataylorme
- What exactly is cleared with "env:clear-cache" by @tlb420
RELEASES
See all- 3.1.1 by @github-actions[bot]
- 3.1.0 by @github-actions[bot]
- 3.0.9 by @github-actions[bot]
- 3.0.8 by @github-actions[bot]
- 3.0.7 by @github-actions[bot]
- 3.0.6 by @github-actions[bot]
- 3.0.5 by @github-actions[bot]
- 2.6.6 by @CdrMarks
- 3.0.4 by @github-actions[bot]
- 3.0.3 by @github-actions[bot]
- 3.0.2 by @jspellman814
- 2.6.5 by @CdrMarks
- 3.0.1 by @jspellman814
- 3.0.0 by @jspellman814
- 2.6.4 by @namespacebrian
- 3.0.0-beta1 by @kporras07
- 2.6.2 by @kporras07
- 2.6.1 by @github-actions[bot]
- by @stovak
- 3.0-alpha5 by @github-actions[bot]
- 2.6.0 by @TeslaDethray
- 2.5.0 by @TeslaDethray
- 2.4.1 by @TeslaDethray
- 2.4.0 by @greg-1-anderson
- 2.3.0 by @TeslaDethray
- 2.2.0 by @TeslaDethray
- 2.1.0 by @oubawaleh
- 2.0.1 by @TeslaDethray
- 2.0.0 by @TeslaDethray
- 1.9.0 by @TeslaDethray
- 1.8.1 by @TeslaDethray
- 1.8.0 by @TeslaDethray
- 1.7.1 by @TeslaDethray
- 1.7.0 by @TeslaDethray
- 1.6.2 by @TeslaDethray
- 1.6.1 by @TeslaDethray
- 1.6.0 by @TeslaDethray
- 1.5.0 by @TeslaDethray
- 1.4.1 by @ronan
- 1.4.0 by @TeslaDethray
- 1.3.0 by @TeslaDethray
- 1.2.1 by @TeslaDethray
- 1.2.0 by @TeslaDethray
- 1.1.2 by @greg-1-anderson
- 1.1.1 by @TeslaDethray
- 1.1.0 by @TeslaDethray
- 1.0.0 by @TeslaDethray
- 1.0.0-beta.2 by @TeslaDethray
- 1.0.0-beta.1 by @TeslaDethray
- 0.13.5 by @TeslaDethray
- 0.13.6 by @ajbarry
- 0.13.4 by @TeslaDethray
- 0.13.3 by @TeslaDethray
- 0.13.2 by @TeslaDethray
- 0.13.1 by @TeslaDethray
- 0.13.0 by @TeslaDethray
- 0.12.0 by @TeslaDethray
- 0.11.4 by @TeslaDethray
- 0.11.3 by @TeslaDethray
- 0.11.2 by @TeslaDethray
- 0.11.1 by @TeslaDethray
- 0.11.0 by @TeslaDethray
- 0.10.6 by @TeslaDethray
- 0.10.5 by @TeslaDethray
- 0.10.4 by @TeslaDethray
- 0.10.3 by @TeslaDethray
- 0.10.2 by @TeslaDethray
- 0.10.1 by @TeslaDethray
- 0.10.0 by @bensheldon
- 0.9.3 by @TeslaDethray
- 0.9.2 by @TeslaDethray
- 0.9.1 by @TeslaDethray
- 0.9.0 by @TeslaDethray
- 0.8.1 by @TeslaDethray
- 0.8.0 by @TeslaDethray
- 0.7.1 by @TeslaDethray
- 0.7.0 by @TeslaDethray
- 0.6.1 by @bensheldon
- 0.6.0 by @TeslaDethray
- 0.5.5 by @mikevanwinkle
- 0.5.4 by @mikevanwinkle
- 0.5.3 by @mikevanwinkle
- 0.5.2 by @mikevanwinkle
- 0.5.1 by @mikevanwinkle
- 0.5.0 by @mikevanwinkle
- 0.4-beta by @mikevanwinkle
- 0.3.4-beta by @mikevanwinkle
- 0.3.3-beta by @mikevanwinkle
- 0.3.2-beta by @mikevanwinkle
- 0.3.1-beta by @mikevanwinkle
- 3.2.1 by @github-actions[bot]
- 3.2.0 by @github-actions[bot]
- 3.1.5 by @github-actions[bot]
- 3.1.4 by @github-actions[bot]
- 3.1.3 by @stovak
- 3.1.2 by @github-actions[bot]