# Connect your UpCloud account

Create an UpCloud API token, connect it to Nuvlo, and create your first UpCloud server.

## Before you start

- An UpCloud account with credit on it. UpCloud is prepaid.
- The **Owner**, **Admin** or **Developer** role on your Nuvlo account

## Step 1: Open API tokens in UpCloud

Sign in to the UpCloud control panel with a user that can create servers, open **Account** → **API Tokens** and click **Add new API token**.

## Step 2: Set up the token

- Name: something you’ll recognize, such as “Nuvlo”.
- Expiration: UpCloud tokens last at most a year. Note the date, because Nuvlo cannot manage your servers after the token expires.
- Leave the option that lets the token create other tokens turned off. Nuvlo doesn’t need it.
- IP restrictions: allow access from all IP addresses. If you restrict the token, UpCloud refuses Nuvlo’s requests.

## Step 3: Copy the token

Click **Create API token** and copy the token. It starts with `ucat_` and is shown only once.

## Step 4: Add the token in Nuvlo

In Nuvlo, open **Integrations** → [Server providers](https://app.nuvlo.dev/dashboard/integrations/server-providers), click **Add provider** and choose **UpCloud**.

![The Add provider dialog with UpCloud among the providers](https://app.nuvlo.dev/docs/shots/connect-a-server-provider--picker.webp)

Enter an **Account label (optional)** and paste the token into **API key or token**.

![The Connect UpCloud dialog with the Account label and API key or token fields](https://app.nuvlo.dev/docs/shots/connect-upcloud--connect-dialog.webp)

## Step 5: Connect and check

Click **Connect account**. Nuvlo checks the token with UpCloud and saves it. The account shows under **Connected accounts**.

![The Connected accounts table with a provider account, its status and the Manage button](https://app.nuvlo.dev/docs/shots/connect-a-server-provider--connected.webp)

## Step 6: Create your first UpCloud server

Open [Create server](https://app.nuvlo.dev/dashboard/servers/create), choose **UpCloud** and, if you have several, the account under **Account**. Click **Choose what to host** and follow [Create a server](https://app.nuvlo.dev/docs/create-a-server).

Prices in the wizard are in your UpCloud account’s currency.

## Good to know

| Topic | On UpCloud |
| --- | --- |
| Billing | Prepaid. Costs come off your UpCloud credit every hour, capped at the monthly price. |
| Plans | General-purpose plans in one price list. |
| Resizing | Any plan, bigger or smaller. The disk can grow but never shrinks, and storage beyond the plan’s own is billed separately. The IP address stays the same. |
| Provider backups | Not managed from Nuvlo. Use [site backups](https://app.nuvlo.dev/docs/back-up-a-site) and snapshots. |
| Snapshots | Restore into a new server. |

> **Warning:** UpCloud shuts your servers down when the credit runs out. Nuvlo sends [provider bill reminders](https://app.nuvlo.dev/docs/provider-bills) in the weeks before, so you can top up in time.

## Troubleshooting

- **The provider rejected this key**: the token was mistyped, revoked, has expired, or is limited to certain IP addresses. Create a new token that allows all IP addresses.
- Your servers stop being manageable after a while: the token has probably expired. Create a new one and paste it under **Manage** on the Server providers page.

---
Source: https://app.nuvlo.dev/docs/connect-upcloud