Add Hetzner as a cloud provider

February 25, 2020

The first step in hosting an application in the cloud is renting one or more servers from a cloud provider. In order to do so, you first need to set up an integration between Smoothy and your preferred cloud provider.

Smoothy supports integrations with different world-leading cloud providers. This way, you prevent vendor lock-in and are free to decide which cloud providers fit your budget and resource requirements best. If you, at a certain point in time, want to migrate to a different provider, you can do so, all via the same familiar interface.

This tutorial walks you step-by-step through the process of setting up an integration between Hetzner and Smoothy.

The tutorial assumes that:

  1. You already have a Hetzner account

Add a Hetzner cloud provider #

To integrate a new cloud provider, head over to your team's integration page. This is accessible via the button in the right upper corner of Smoothy, as shown in the screenshot below.

Team navigation

The cloud providers section is located at the top of the integrations page, as shown in the screenshot below. Hover the button in the upper right corner of the cloud providers table and click Add cloud provider.

Cloud providers

Next, a modal appears, similar to the one in the screenshot below. In this modal, you have to select which cloud provider that you like to set up an integration with. Given the focus of this tutorial, this should be Hetzner.

You can also specify a name for your cloud provider. By default, Smoothy fills out this field for you so you can leave it untouched. However, if you have multiple Hetzner integrations, you can assign each of them a distinctive name.

Integrate with Hetzner

In the next step of the process, you need to specify an API Token that grants Smoothy access to your Hetzner account. To obtain such a token, you can follow along with the steps below.

Integrate with Hetzner

First, head over to your Hetzner control panel. Select the project that you want to integrate with Smoothy, or create a new one.

Integrate with Hetzner

Open the navigation on the left-hand side of the page and click on the menu item Access.

Integrate with Hetzner

On the Access page, use the navigation at the top of the page to navigate to the API Tokens page. This page gives you an overview of all the API tokens that you have generated for your account in the past. To generate a new token, click the button labeled Generate API token.

Integrate with Hetzner

This will open up a form in which you have to specify a description for your token. It is recommended to use the word Smoothy in the description so that you at a later point in time remember that this specific token was created to be used with Smoothy.

Integrate with Hetzner

As soon as you click Generate API Token, your new API token appears. Copy this token to your clipboard and head back to Smoothy.

Integrate with Hetzner

Finally, paste your API token in the respective field and hit Create.

Integrate with Hetzner

Your new Hetzner integration should now appear on your team's integrations page.

Where to go from here? #

Now that you have successfully established an integration between Hetzner and Smoothy, you are ready to create your first deployment. To do so, you can follow along with one of these tutorials.

Michiel Kempen

Michiel Kempen

A passionate cloud engineer who helps software companies adopt modern cloud technologies through an intelligent all-in-one cloud platform called Smoothy.