Terminus
The Pantheon
Command-Line
Interface

SANDcamp 2014.01.25 - https://github.com/pantheon-systems/terminus
What is Terminus?
● https://github.com/pantheon-systems/terminus

● CLI for Pantheon Dashboard operations
● Uses Drush
● Open-source
What does Terminus do?
● Makes API calls to Pantheon
● Does NOT interact with your Drupal site
What can I do with Terminus?
●
●
●
●

Update drush aliases
Site operations
Workflow operations
Team operations
Why should I be using Terminus?
● Fast
○ No browser overhead
○ Makes direct API calls

● Scriptable
○ Common operations
○ CI workflows
Terminus dependencies
●
●
●
●
●

cURL - http://curl.haxx.se/
Composer - https://getcomposer.org/
git - http://git-scm.com/
drush - http://www.drush.org/
PHP 5.3
Terminus installation
# Download
git clone https://github.com/pantheon-systems/terminus.git
$HOME/.drush/terminus

cd $HOME/.drush/terminus
# Get dependencies
composer update --no-dev
# Clear Drush cache
drush cc drush
Updating Terminus
# Update Terminus.
cd $HOME/.drush/terminus
git pull
# Update Terminus dependencies.
composer update --no-dev
# Clear Drush's cache.
drush cc drush
What commands are available?
drush help --filter=terminus
drush pauth
● Authenticate, required
● drush pauth email -password=”1234”
drush paliases
● Update Pantheon drush aliases, clear cache
drush psites
List sites associated with your account
drush psite-create
● Create a new site on
Pantheon
○ Label, machine name
○ Organization (if any)
○ Start state

● Polls
● Can be completely
scripted
drush psite-cmode
● Change connection mode
○ SFTP
○ Git

● Use in conjunction with psite-commit
drush psite-deploy
● Deploy code changes to an environment
backups
● psite-backups
○ List backups

● psite-backup
○ Create backup

● psite-get-backup
○ Get links to download backup
Multidev support
● psite-elist
○ List multidev environments

● psite-ecreate
○ Create multidev environment
○ Clone from target environment

● psite-edelete
○ Delete multidev environment
drush psite-import
● Import drush site archive from remote URL
● Great for trainings
Other useful commands
● Locking (basic auth)
○ psite-eli, psite-elo, psite-eul

● Team
○ psite-team, psite-team-add, psite-team-remove

● Redis clear
○ psite-erc

● SSH Tunnel
○ psite-tunnel, psite-tunnel-close, psite-tunnels
Ways to use Terminus
● Day-to-day operations
● Automating site migrations
● Continuous Integration
Thank you! Questions?
@getpantheon
irc.freenode.net #pantheon
getpantheon.com
https://github.com/pantheon-systems/terminus

Terminus, the Pantheon command-line interface