Skip to end of metadata
Go to start of metadata

The Joyent Cloud API is a RESTful API for programmatically interfacing with the Joyent Public Cloud. Many of the tasks that you can perform through the portal are also possible through CloudAPI including:

  • Provision new machines
  • Manage your account credentials
  • Create custom analytics for monitoring your infrastructure

In this page, you will learn how to install the Cloud API command line tools. You can learn more about CloudAPI at

The CloudAPI tools require Node.js. You can find the latest version of Node.js at

Once Node.js is installed, install the CloudAPI tools. This command installs the CloudAPI tools globally.

If you get an EACCESS error, you may need to use sudo to install globally:

Next, set up your environment variables. You can set these in your .bashrc or .bash_profile file.

For SDC_URL choose the datacenter that hosts your instances, or the one closest to you:

Datacenter URL Location Virginia, USA San Francisco Area, USA Las Vegas, USA Amsterdam, Netherlands

You can find the SSH fingerprint for your keys in the Joyent Cloud Portal under My Account > SSH Keys.

For example, your setup might look something like this:

Test that everything is set up correctly:

cli cli Delete
dsa dsa Delete
node-smartdc node-smartdc Delete
rsa rsa Delete
environment environment Delete
variable variable Delete
smartdc smartdc Delete
ssh ssh Delete
api api Delete
cloudapi cloudapi Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.