DigitalOcean — add API token
Generate a DigitalOcean API token to enable Bring Your Own Keys provisioning.
DigitalOcean uses account-scoped API tokens. You generate one in the DigitalOcean Control Panel, then paste it into StoreFrame's provider settings. Once registered, you can subscribe to a paid Project that provisions Droplets on your DigitalOcean account.
1. Open DigitalOcean Control Panel
Sign in at https://cloud.digitalocean.com/.
API tokens apply to your DigitalOcean account. Environments that StoreFrame creates appear as Droplets under that account. If you use separate DigitalOcean teams or accounts for different workloads, add one token per account in StoreFrame.
2. Generate the API token
Go to API in the left sidebar (under Account), open the Tokens / Keys tab, and click Generate New Token.
Two settings matter:
- Token name: Use something descriptive — for example,
storeframe-prod. This label appears in your token list and makes it easy to identify what the token is used for. - Scopes: Select Read and Write (or a custom scope that includes write access to Droplets). StoreFrame needs write access to create Droplets, attach storage, and configure networking. A read-only token will fail validation.
Click Generate Token. DigitalOcean shows the token only once — copy it to your clipboard immediately before closing the dialog.
3. Paste into StoreFrame
In the Hub, go to Settings → Organization → Providers and click Add provider.
Fill in the form:
- Cloud Provider: Select DigitalOcean
- Name: A label for your reference — for example,
DigitalOcean — prod account. This appears only in StoreFrame and helps you tell tokens apart if you add more than one. - API Token: Paste the token you copied in Step 2.
Click Save. StoreFrame validates the token against DigitalOcean's API. If validation fails, the most common cause is a token generated with read-only permissions — generate a new one with Read and Write access and try again.
Next
With a DigitalOcean token registered, you can subscribe to a paid Project from any trial environment. See billing trials for the conversion mechanics.
You can rotate or remove this token later from organization providers settings.