Skip to content
Rowsafe
Docs
Connect a cloud account

Connect DigitalOcean

Give Rowsafe a DigitalOcean personal access token so it can create database servers (Droplets) there.

To create servers for you in DigitalOcean, Rowsafe needs a personal access token. It takes about two minutes.

Create the token

Choose the team

Sign in to DigitalOcean. A token reaches its whole team, so you may want a new team just for these databases.

Generate the token

Open API, then Tokens, and click Generate New Token. Name it Rowsafe and pick an expiration (No expiry, or a date you'll remember). Choose Custom Scopes with the scopes below, or Full Access.

Paste it into Rowsafe

Click Generate Token and copy it now: DigitalOcean shows it only once. In the dashboard, open Settings → Cloud accounts (or Create a server for me) and click Connect a cloud account. Choose DigitalOcean, paste the token into Personal access token, name the account and click Connect.

Rowsafe checks the token first, without creating anything that costs money (it adds the free tag rowsafe). A read-only token is refused.

What access this gives Rowsafe

With Custom Scopes, Rowsafe needs only these:

account:read
actions:read
droplet:create, droplet:read, droplet:update, droplet:delete
firewall:create, firewall:read, firewall:update, firewall:delete
regions:read
sizes:read
image:read
ssh_key:create, ssh_key:read
tag:create, tag:read

Scopes apply to the whole team (DigitalOcean can't limit a token to one project). Full Access could do anything in the team.

Rowsafe only touches what it creates, all tagged rowsafe:

  • Droplets (Debian 13, or 12 where 13 isn't offered), only when someone clicks and confirms;
  • cloud firewalls, one per server, letting in only your addresses;
  • SSH keys, only the ones you give it. Never its own.

See what Rowsafe does with your cloud account.

Revoke it

  • In DigitalOcean: API, Tokens: delete the Rowsafe token. It stops working at once.
  • In Rowsafe: Settings → Cloud accounts, Remove (once its servers are deleted). Nothing in DigitalOcean changes.

After you revoke it, or it expires, your servers keep running and stay protected. Resize, firewall changes and deletes then happen in the DigitalOcean control panel.

Good to know

  • Prices are DigitalOcean's own. Your DigitalOcean bill is what counts.
  • If you reach DigitalOcean's Droplet limit, Rowsafe says so: delete one, or ask DigitalOcean to raise it.
  • Disks can't shrink, so resizing offers only sizes with at least the same disk.
Edit on GitHub