← All Articles

Getting started with Cloud 66 Toolbelt

Kasia HoffmanKasia Hoffman
Oct 12th 16Updated Aug 9th 21


This feature series will focus on the Cloud 66 Toolbelt and will be organized into three parts: for beginners, intermediate and advanced level users. This is part one.

What is Toolbelt

Toolbelt is the Cloud 66 command line tool. It wraps our open source API library, allowing developers to manage and interact with their stacks using their Cloud 66 account. Additionally, it provides you with access to advanced configuration options and is available for Linux, Mac and Windows users.

Getting started

To get started, log in to your Cloud 66 account, scroll to the bottom of the page and click on Get Toolbelt. Download the toolbelt executable and install it directly to your PATH.

Note: You'll need to link the Toolbelt to your Cloud 66 account before you start using it. To do this, issue the following command:

$ cx stacks list

This command will direct you to the URL, which you need to copy and paste into your browser. This URL will redirect you to your account and ask for authorization. Once that's done, copy and paste the given code directly to your Toolbelt and you're ready to go.

For more details, check out our introduction to Toolbelt help page


What next?

Ok, now you have Cloud 66 Toolbelt successfully installed and you have already used your first command line, you can now start to explore it further. As a beginner, I'd recommend you start by redeploying a stack using Toolbelt. This will help you become more familiar with the process.

  • Redeploy your stack

To redeploy your existing stack, you can either click on the redeploy button in our UI, or you can use our $ cx redeploy command line.

In situations when you need to redeploy the same stack multiple times, it will automatically enqueue your redeployment command and will run it immediately after the current deployment is finished.

This is how you can use the redeploy command line (where s = stack, y = automatically answer yes to any prompts and e = your stack environment)

$ cx redeploy [-s <stack>] [-y] [--git-ref <git_ref>] [--service <service>] [--service <service>] [--service <service>]


For a list of parameters and more examples please visit our help page.

Command lines to view your toolbelt info

The following commands are useful if you need to find out more information about your toolbelt.

  • cx help - lists available commands
  • cx info - shows information about your toolbelt
  • cx --version - outputs your toolbelt version
  • cx stacks list - lists available stacks
  • cx servers list -s <stack_name> - lists available servers in a given stack
  • cx open -s <stack_name> - opens your web browser to visit the app server in your stack

Once you're confident you've got the hang of things, you can explore our Toolbelt command directory listed on our help page. Additionally, you can read part two of this post and start using more complicated command lines.

Stay tuned.

Try Cloud 66 for Free, No credit card required