> For the complete documentation index, see [llms.txt](https://docs.termius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.termius.com/integrations/digitalocean.md).

# Integration with DigitalOcean

{% hint style="info" icon="sparkle" %}
**Who can use this feature:**

* **Subscriptions:** Pro, Team, Business, and Enterprise
* **Set up:** macOS, Windows and Linux. 
* **Imported hosts available:** macOS, Windows, Linux, iOS and Android
  {% endhint %}

## Overview

This integration securely imports DigitalOcean Droplets into a group in Termius that automatically updates to reflect the changes in your DigitalOcean environment. When you add or remove a Droplet, or change a Droplet's details, the host entry in Termius will appear, disappear, or update accordingly.

## Configure DigitalOcean access

<figure><img src="/files/YGCy8Kv1tZArK8CqQdLS" alt=""><figcaption></figcaption></figure>

To connect Termius to your DigitalOcean account, you need to create a **personal access token** with read-only scope. Termius will use it to access information about your DigitalOcean environment.

The **personal access token** you enter in Termius is stored locally and are not synced across devices.

{% hint style="success" icon="circle-info" %}
For each Droplet, Termius imports the **Name** and **public IP address** if it exists, or otherwise a private one.
{% endhint %}

### Create a personal access token <a href="#token" id="token"></a>

1. Log in to the [DigitalOcean Control Panel](https://cloud.digitalocean.com)
2. In the left menu, go to `Account` → `API` to open the **Applications & API** page on the **Tokens** tab

   <figure><img src="/files/6Psth3HEXvcQUVF5uKCA" alt=""><figcaption></figcaption></figure>
3. In the **Personal access tokens** section, click `Generate New Token`&#x20;

   <figure><img src="/files/RC0VRJz94kxkiqSUWJmz" alt=""><figcaption></figcaption></figure>
4. Fill out the form:

   1. Enter a **Token Name**
   2. Set the **Expiration**. The default is 90 days. If you don't want the token to be renewed periodically, select `No expiry`.
   3. Under **Scopes**, select `Read Only`&#x20;

   <figure><img src="/files/ZamMJshiJwWA5PBjOGQr" alt=""><figcaption></figcaption></figure>
5. Click `Generate Token`
6. Copy and save your `Personal token` immediately. You will need this token to set up the DigitalOcean integration in Termius. **DigitalOcean will not display it again for security purposes**

   <figure><img src="/files/mP69GAOuQE1zefCuRWLm" alt=""><figcaption></figcaption></figure>

Your personal access token is now set up and Termius can load information about your Droplets.

{% hint style="info" %}
For the up-to-date instructions, see the [DigitalOcean documentation](https://docs.digitalocean.com/reference/api/create-personal-access-token/).
{% endhint %}

## Enable DigitalOcean integration in Termius <a href="#enable" id="enable"></a>

1. On the `Hosts` screen, click the chevron next to the `New Host` button and choose `DigitalOcean Integration`&#x20;

   <figure><img src="/files/am0ufjqQHs7jcVPD1GOv" alt=""><figcaption></figcaption></figure>
2. In the `Label` field, enter a name for the group

   <figure><img src="/files/wK9KhATon9rDDoJbFV1Z" alt=""><figcaption></figcaption></figure>
3. Paste your personal access token into the `Token` field

   <figure><img src="/files/YGCy8Kv1tZArK8CqQdLS" alt=""><figcaption></figcaption></figure>
4. (Optional) You can configure additional SSH settings for the group, such as port or credentials. Click `Add protocols` below the Cloud sync settings, and fill out the required fields. For more details, see [Groups and tags](/organize-and-connect-to-hosts/groups-and-tags.md)

   <figure><img src="/files/AV1PnAwCCsXTg1lNhNaA" alt=""><figcaption></figcaption></figure>
5. Termius automatically saves the group and begins importing your DigitalOcean Droplets

{% hint style="info" %}
The **personal access token** you enter in Termius is stored locally and are not synced across devices.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.termius.com/integrations/digitalocean.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.