Provision an UpCloud Server with the UpCloud API

5 min read

In this article, we’ll be provisioning an UpCloud VPS directly from within our GridPane dashboard using the UpCloud API


UpCloud have an IPv4 limit on accounts, which means that after creating your first 15 servers, you may need to get in touch to get this limit removed. The UpCloud team will able to do for you quickly and efficiently upon request.

Step 1. Login to your UpCloud account and navigate to the “People” page

Login to your UpCloud account and click on People in the navigation bar.

Step 2. Create a new sub-user for your account

The way UpCloud works is a little different to other API providers. We’ll be creating a new sub-user and giving them API access. We’ll then use this sub-users login details inside your GridPane account to use the API.

Fill in the subaccount details and check the API checkbox as outlined in the image below:

Tip: If you’re using Gmail or GSuite, you can use the same email address by using a handy feature that works as follows:

Email address =

Workaround =

Use a + followed by whatever you wish, and emails will go to your primary inbox as usual. This is useful for many things (like email newsletter signups and spotting companies who sell your info), but here means you don’t require a new email account.

Always use a strong password.

When you’re done click the create user button


If the sub-user in Upcloud is deleted and a new sub-user added, please make sure that the new sub-user has access to all the servers in your GridPane account.

This can be done in the Server Access section:

Step 3. Connect your new sub-user inside your GridPane account

Head over to your GridPane account and navigate through to the settings page.

In the left-hand sidebar select Cloud Providers and then click on the UpCloud tab. Here you can enter the username (not the email address) and password of the sub-user you just created in step 2.

Once you’ve saved your details it will look like this:

UpCloud: Backups Notice

UpCloud's new simple backups feature has not yet been implemented via their API and PHP SDK, but they will be releasing it in just a few weeks. In the meantime, if you would like to enable server backups at UpCloud you will need to do so inside of your UpCloud account.

To do this, login to UpCloud and click through to your Servers page, then click on the server you wish to edit. Here you will see a backups tab at the top, and in the tab you will see the various different options that they offer. Choose your preferred backups window and click save.

Step 4. Spin up an UpCloud Server

Head to your servers page and click on UpCloud. You’ll be presented with options for your server – choose your server size and whether you wish to enable UpCloud server backups (we highly recommend that you enable provider level backups – but please ensure you read the above beta message and set backups inside your UpCloud account until further notice – we’ll update this article again ASAP).

Step 5. Wait for 10-15 minutes for your server to provision

UpCloud works a little different to our other API integrations. Servers are built using terraformm which is an infrastructure as code software tool. During the server build there won’t be any callbacks/updates on the process, it will simply display as “Active” along with a green “Provisioned” bar.

Step 6. Start adding new sites

Your server is now provisioned and ready for you to start adding new websites.