DigitalOcean — Key handoff
What you need
Section titled “What you need”- The DigitalOcean personal access token (begins
dop_v1_) you copied at the end of DigitalOcean — Setup. If you don’t have it, generate a new one — it is shown only once. - The PhoenixVPS app, open at the DigitalOcean panel.
Step 1 — Paste the token into PhoenixVPS
Section titled “Step 1 — Paste the token into PhoenixVPS”In PhoenixVPS’s DigitalOcean panel, find Step 3 — Paste the API token. Click the box labelled “Paste DigitalOcean API token here…” and paste the token.
(paste your DigitalOcean token — a long string beginning dop_v1_)Step 2 — Connect
Section titled “Step 2 — Connect”Click Validate & Connect.
What you see: PhoenixVPS checks the token against the DigitalOcean API (usually under five seconds). The Status line near the bottom of the panel updates to confirm the account is connected.
If you see an error instead, see Troubleshooting.
What happens next
Section titled “What happens next”PhoenixVPS can now create and tear down a VPN server (a “droplet”) in your DigitalOcean account using the token. To start a session, return to the main screen and click Connect.
Remember: a running droplet bills until you tear it down. Use Tear Down VPN Server when you are finished (see the FAQ), and see the Pricing page for cost details.
Troubleshooting
Section titled “Troubleshooting””Invalid token”
Section titled “”Invalid token””The token was probably truncated when copied. DigitalOcean shows the token only once, so if you’re unsure you copied all of it, generate a fresh one: in the DigitalOcean Console go to API → Tokens, delete the old token, and create a new Full Access token (see DigitalOcean — Setup).
The token connects but the server fails to start
Section titled “The token connects but the server fails to start”The most common cause is a Read Only token. PhoenixVPS needs Full Access (or a Custom Scope token with write access) to create a droplet. Generate a new token with the right scope and connect again.
A regional capacity limit can also cause this — try a different region.
Revoking access
Section titled “Revoking access”To remove PhoenixVPS’s access to your DigitalOcean account:
- In PhoenixVPS, click Disconnect / Revoke. This deletes the locally stored token and tears down any droplet the app is managing.
- To fully revoke it, open the DigitalOcean Console → API → Tokens, find the PhoenixVPS token, open its ⋯ menu, and choose Delete.
After the token is deleted, PhoenixVPS can no longer create or manage anything in your DigitalOcean account.