Command line interface to Aptible
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib/aptible Version 0.16.1 Jul 30, 2018
spec Merge pull request #249 from adrian-gomez/master Jul 30, 2018
.travis.yml Update README sync script & Contributing instructions Sep 21, 2017
Gemfile Pin Rack to 1.x Apr 21, 2017 Initial commit (Straptible 0.2.1) Dec 21, 2013
Rakefile Initial commit (Straptible 0.2.1) Dec 21, 2013
appveyor.yml Constantize spawn options and signal type Nov 2, 2016
aptible-cli.gemspec Bump aptible-resource May 11, 2018
codecov.yml Only report coverage, don't set a failing status on branches or PRs Jun 15, 2016

Aptible CLI

Gem Version Build Status Dependency Status codecov Roadmap

Command-line interface for Aptible services.


NOTE: To install the aptible tool as a system-level binary, Aptible recommends you install the Aptible Toolbelt, which is faster and more robust.

Add the following line to your application's Gemfile.

gem 'aptible-cli'

And then run bundle install.


From aptible help:

  aptible apps                                                                                                                       # List all applications
  aptible apps:create HANDLE                                                                                                         # Create a new application
  aptible apps:deprovision                                                                                                           # Deprovision an app
  aptible apps:scale SERVICE [--container-count COUNT] [--container-size SIZE_MB]                                                    # Scale a service
  aptible backup:list DB_HANDLE                                                                                                      # List backups for a database
  aptible backup:restore BACKUP_ID [--environment ENVIRONMENT_HANDLE] [--handle HANDLE] [--container-size SIZE_MB] [--size SIZE_GB]  # Restore a backup
  aptible config                                                                                                                     # Print an app's current configuration
  aptible config:add [VAR1=VAL1] [VAR2=VAL2] [...]                                                                                   # Add an ENV variable to an app
  aptible config:rm [VAR1] [VAR2] [...]                                                                                              # Remove an ENV variable from an app
  aptible config:set [VAR1=VAL1] [VAR2=VAL2] [...]                                                                                   # Add an ENV variable to an app
  aptible config:unset [VAR1] [VAR2] [...]                                                                                           # Remove an ENV variable from an app
  aptible db:backup HANDLE                                                                                                           # Backup a database
  aptible db:clone SOURCE DEST                                                                                                       # Clone a database to create a new one
  aptible db:create HANDLE [--type TYPE] [--version VERSION] [--container-size SIZE_MB] [--size SIZE_GB]                             # Create a new database
  aptible db:deprovision HANDLE                                                                                                      # Deprovision a database
  aptible db:dump HANDLE [pg_dump options]                                                                                           # Dump a remote database to file
  aptible db:execute HANDLE SQL_FILE                                                                                                 # Executes sql against a database
  aptible db:list                                                                                                                    # List all databases
  aptible db:reload HANDLE                                                                                                           # Reload a database
  aptible db:restart HANDLE [--container-size SIZE_MB] [--size SIZE_GB]                                                              # Restart a database
  aptible db:tunnel HANDLE                                                                                                           # Create a local tunnel to a database
  aptible db:url HANDLE                                                                                                              # Display a database URL
  aptible db:versions                                                                                                                # List available database versions
  aptible deploy [OPTIONS] [VAR1=VAL1] [VAR2=VAL2] [...]                                                                             # Deploy an app
  aptible domains                                                                                                                    # Print an app's current virtual domains - DEPRECATED
  aptible endpoints:database:create DATABASE                                                                                         # Create a Database Endpoint
  aptible endpoints:deprovision [--app APP | --database DATABASE] ENDPOINT_HOSTNAME                                                  # Deprovision an App or Database Endpoint
  aptible endpoints:https:create [--app APP] SERVICE                                                                                 # Create an App HTTPS Endpoint
  aptible endpoints:https:modify [--app APP] ENDPOINT_HOSTNAME                                                                       # Modify an App HTTPS Endpoint
  aptible endpoints:list [--app APP | --database DATABASE]                                                                           # List Endpoints for an App or Database
  aptible endpoints:renew [--app APP] ENDPOINT_HOSTNAME                                                                              # Renew an App Managed TLS Endpoint
  aptible endpoints:tcp:create [--app APP] SERVICE                                                                                   # Create an App TCP Endpoint
  aptible endpoints:tcp:modify [--app APP] ENDPOINT_HOSTNAME                                                                         # Modify an App TCP Endpoint
  aptible endpoints:tls:create [--app APP] SERVICE                                                                                   # Create an App TLS Endpoint
  aptible endpoints:tls:modify [--app APP] ENDPOINT_HOSTNAME                                                                         # Modify an App TLS Endpoint
  aptible help [COMMAND]                                                                                                             # Describe available commands or one specific command
  aptible login                                                                                                                      # Log in to Aptible
  aptible logs [--app APP | --database DATABASE]                                                                                     # Follows logs from a running app or database
  aptible operation:cancel OPERATION_ID                                                                                              # Cancel a running operation
  aptible ps                                                                                                                         # Display running processes for an app - DEPRECATED
  aptible rebuild                                                                                                                    # Rebuild an app, and restart its services
  aptible restart                                                                                                                    # Restart all services associated with an app
  aptible services                                                                                                                   # List Services for an App
  aptible ssh [COMMAND]                                                                                                              # Run a command against an app
  aptible version                                                                                                                    # Print Aptible CLI version

Output Format

By default, the Aptible CLI outputs data as unstructured text, designed for human consumption.

If you need to parse the output in another program, set the APTIBLE_OUTPUT_FORMAT environment variable to json when calling the Aptible CLI for JSON output.

The default format is text.


  1. Fork the project.
  2. Commit your changes, with specs.
  3. Ensure that your code passes specs (rake spec) and meets Aptible's Ruby style guide (rake rubocop).
  4. If you add a command, sync this README (bundle exec script/sync-readme-usage).
  5. Create a new pull request on GitHub.


Copyright and License

MIT License, see LICENSE for details.

Copyright (c) 2016 Aptible and contributors.