Skip to content
anderly edited this page Nov 6, 2014 · 12 revisions

The dnsimple-cli allows you to login to and manage multiple accounts.

Logging in to an Account

To login, use the dnsimple login command:

# This will prompt for your password in the console
dnsimple login -u <your dnsimple account email address>

NOTE: The last account you login to will be set as the current account where commands will be issued.

Changing the Current Account

To change the current account, use the dnsimple account set command:

dnsimple account set <desired account email address or subscription id>

Listing the Currently Authenticated Accounts

You can find out which accounts you are currently authenticated against by using the dnsimple account list command. This provides useful information such as the account email address, subscription ID, whether or not the account is the currently selected account and which environment the account is associated with.

dnsimple account list

info:    Executing command account list
data:    Name                      Id    Current  Environment
data:    ------------------------  ----  -------  -----------
data:    user@example.com          1234  true     Production 
data:    test@example.com          5678  false    Sandbox 
info:    account list command OK

Showing Account Details

You can see details about an authenticated account using the dnsimple account show [subscription] command. [subscription] is the account email address or subscription ID. If no [subscription] is provided, it defaults to the current account.

dnsimple account show

info:    Executing command account show
data:    ID:               1234
data:    Name:             user@xample.com
data:    Is Default:       true
data:    Environment:      Production
data:    Has Access Token: Yes
info:    account show command OK

<< Command Syntax | Managing Domains >>