Aptible Toolbelt

A command-line interface for your Aptible services

macOS

Download the macOS binary.

Windows

Download the Windows binary.

Ubuntu

Download a binary for Ubuntu 14.04 or 16.04

Debian

Download a binary for Debian 7 or 8

Enterprise Linux

Download a binary for Enterprise Linux 6 or 7

Download Aptible Toolbelt for macOS

Download v0.8.4 for macOS

Installation Instructions

When the download completes, use your package manager (graphical or command line) and install the package. You'll need to use sudo to elevate your permissions.
  • Ubuntu 14.04 https://omnibus-aptible-toolbelt.s3.amazonaws.com/aptible/omnibus-aptible-toolbelt/master/132/pkg/aptible-toolbelt_0.8.4%2B20170125114555%7Eubuntu.14.04-1_amd64.deb
  • Ubuntu 16.04 https://omnibus-aptible-toolbelt.s3.amazonaws.com/aptible/omnibus-aptible-toolbelt/master/132/pkg/aptible-toolbelt_0.8.4%2B20170125114552%7Eubuntu.16.04-1_amd64.deb

Installation Instructions

When the download completes, use your package manager (graphical or command line) and install the package. You'll need to use sudo to elevate your permissions.
  • Debian 7 https://omnibus-aptible-toolbelt.s3.amazonaws.com/aptible/omnibus-aptible-toolbelt/master/132/pkg/aptible-toolbelt_0.8.4%2B20170125114551%7Edebian.7.11-1_amd64.deb
  • Debian 8 https://omnibus-aptible-toolbelt.s3.amazonaws.com/aptible/omnibus-aptible-toolbelt/master/132/pkg/aptible-toolbelt_0.8.4%2B20170125114559%7Edebian.8.6-1_amd64.deb

Installation Instructions

When the download completes, use your package manager (graphical or command line) and install the package. You'll need to use sudo to elevate your permissions.
  • EL 6 https://omnibus-aptible-toolbelt.s3.amazonaws.com/aptible/omnibus-aptible-toolbelt/master/132/pkg/aptible-toolbelt-0.8.4%2B20170125114956%7Ecentos.6.8-1.el6.x86_64.rpm
  • EL 7 https://omnibus-aptible-toolbelt.s3.amazonaws.com/aptible/omnibus-aptible-toolbelt/master/132/pkg/aptible-toolbelt-0.8.4%2B20170125115001%7Ecentos.7.2.1511-1.el7.x86_64.rpm

Download Aptible Toolbelt for Windows

Download v0.8.4 for Windows
Requires 64 bit Windows 8.1 or greater or 64 bit Windows Server 2012r2 or greater

Getting Started

Logging In

Once installed, you'll have access to the aptible command from your command shell. Log in using the email address and password you used when creating your Aptible account:

$ aptible login
Email: skylar@aptible.com
Password:
2FA Token: 555999
Success! Token written to $HOME/.aptible/tokens.json

Getting Started

Create an App

You're now ready to create your first Aptible app. Use the aptible apps:create command to create an app. Once the app is created, you’ll be shown a git remote you can push your app to.

$ aptible apps:create healthco-on-rails
healthco-on-rails created successfully!
git remote:
git@beta.aptible.com:healthco-on-rails.git

Full CLI Command Reference

$ aptible help
Commands:
  aptible apps
  aptible apps:create HANDLE
  aptible apps:deprovision
  aptible apps:scale TYPE NUMBER
  aptible backup:list DB_HANDLE
  aptible backup:restore [--handle HANDLE] [--size SIZE_GB]
  aptible config
  aptible config:add
  aptible config:rm
  aptible config:set
  aptible config:unset
  aptible db:backup HANDLE
  aptible db:clone SOURCE DEST
  aptible db:create HANDLE
  aptible db:deprovision HANDLE
  aptible db:dump HANDLE
  aptible db:execute HANDLE SQL_FILE
  aptible db:list
  aptible db:tunnel HANDLE
  aptible domains
  aptible help [COMMAND]
  aptible login
  aptible logs
  aptible ps
  aptible rebuild
  aptible restart
  aptible ssh [COMMAND]
  aptible version
 
 
# List all applications
# Create a new application
# Deprovision an app
# Scale app to NUMBER of instances
# List backups for a database
# Restore a backup
# Print an app's current configuration
# Add an ENV variable to an app
# Remove an ENV variable from an app
# Alias for config:add
# Alias for config:rm
# Backup a database
# Clone a database to create a new one
# Create a new database
# Deprovision a database
# Dump a remote database to file
# Executes sql against a database
# List all databases
# Create a local tunnel to a database
# Print an app's current virtual domains
# Describe available commands or one specific command
# Log in to Aptible
# Follows logs from a running app
# Display running processes for an app - DEPRECATED
# Rebuild an app, and restart its services
# Restart all services associated with an app
# Run a command against an app
# Print Aptible CLI version