TurnKey Linux Virtual Appliance Library

Announcing public API for TurnKey Hub

More power, control, flexibility and automation of cloud servers.

Alan Kay once said: "Simple things should be simple, complex things should be possible". We live by those words, and I think we've done a pretty good job up until now.

The Hub makes launching and managing instances on Amazon EC2 really simple, but the one thing that has been missing is a solution to make complex things possible - i.e., programmatic control.

Which brings me to todays announcement of the TurnKey Hub API, and HubTools - Python API bindings and CLI tools.

Some examples to wet your appetite:

Launch a new TurnKey Core appliance in the cloud:

$ hub-launch core

And of course, preseeding is supported, for example:

$ hub-launch lamp --db-pass=foobar

But wait, there's more. Lets say you are developing a new Wordpress website in a local VM which is backed up using TKLBAM, with a backup ID of 2. Restoring the backup to a new cloud server is as simple as:

$ hub-launch 2

So how do you know what backups you have available? Which appliances are available and their preseeding options? The status and related information of your cloud servers?

It's easy:


If the included CLI tools aren't enough and you need more power, use the Python bindings to develop your own code. It's really simple.

For example, lets say I wanted to launch 10 TKL Core servers:

for i in range(1, 11):
    hub.servers.launch("core", label="TurnKey Core %s" % i)

There is so much you can do with HubTools, it's only limited to your imagination.

The full documentation is available here. If you don't have a free Hub account yet, get one here.

You can get future posts delivered by email or good old-fashioned RSS.
TurnKey also has a presence on Google+, Twitter and Facebook.


Jeremiah's picture

Great Job!

Nice work.  I'm sure this will really make TurnKey look even more appealing as an enterprise grade solution.

I'm impressed with the way all the pieces of TurnKey just fit together like a puzzle pieces.  Even as new functionality is added it never seems like something gets patched onto the existing framework.  Instead, it just integrates smoothly with what's already there.

Thanks for all that you're doing.

Liraz Siri's picture

Not just adding random features

While the new Hub features are coming out incrementally, they really are part of a bigger unifying vision. I don't like to hype up vaporware, but we have a lot of great ideas we're working on and we like to think we're just getting started. There's a big gap between what the Hub does right now and what we envision it doing in the future.

Also note that we're using the Hub internally to help develop and test TurnKey, so we're probably using it more than the typical user and run into its limits sooner. We're scratching our own itch, and the community benefits from that.

Guest's picture

Complimentary features against OpenStack ?

Hello, I have 2 questions, in order to further understand the Hub API and it's direction towards programmability.

  1. How do you envision the Hub API and it's features, or planned features, in comparison to OpenStack and it's API ? www.openstack.org and http://docs.openstack.org/
  2. And how do you see your effort as being different or alike ?

Curious, and I look forward to your responses !

Liraz Siri's picture

Apples to oranges

The Hub is a service that acts as higher-level interface optimized for TurnKey that sits between you and service providers such as Amazon Web Services. In the future other cloud providers besides AWS will be supports. Private clouds will also eventually be supported. We think OpenStack is one of the most interesting offerings and it will probably be one of the first non-AWS platforms the Hub supports.

In comparison, OpenStack is software you run on bare metal to create a private/public cloud. The Hub doesn't do that.

Guest's picture



Don't know if this is a dumb question but can you put in a link for the API ?




Alon Swartz's picture

You're looking for HubTools.

You're looking for HubTools.

Post new comment

The content of this field is kept private and will not be shown publicly. If you have a Gravatar account, used to display your avatar.
  • Web page addresses and e-mail addresses turn into links automatically.
  • Allowed HTML tags: <a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr> <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tr> <td> <em> <b> <u> <i> <strong> <font> <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code> <cite> <strike> <caption>

More information about formatting options

Leave this field empty. It's part of a security mechanism.
(Dear spammers: moderators are notified of all new posts. Spam is deleted immediately)