Connect a DigitalOcean server to Zefily
DigitalOcean droplets can be created from Zefily with the agent installed on first boot. DigitalOcean gives no initial password, so this guide also sets up the SSH key the create step needs.
Before you start
- A DigitalOcean account with a team role that can create droplets.
- A Zefily account that can manage servers and integrations in the organization.
- An SSH key pair on your computer; the public key goes into Zefily.
Steps
-
1. Open the API page in DigitalOcean
Log in to the DigitalOcean Control Panel and click Account in the main menu, then API. The page opens on the Tokens tab.
-
2. Generate a personal access token
In the Personal access tokens section, click Generate New Token. Enter a name for your reference and choose the expiry.
-
3. Choose the scope
Choose Full Access for read and write access to everything your team role allows. Or choose Custom Scopes and select the Droplet permissions that let Zefily create, power-cycle, snapshot and delete droplets. Read Only cannot create servers.
-
4. Copy the token now
Click Generate Token and copy the secret at once. DigitalOcean shows it only once.
-
5. Add the token to Zefily
In Zefily open Settings, then Cloud providers. Choose DigitalOcean, enter a name and paste the token. The token is verified when you connect it.
-
6. Add your SSH key
DigitalOcean requires a key: it offers no server without one. Open Settings, then SSH keys, and add the public key you sign in with.
-
7. Create the droplet
Choose Servers, then Add server, pick the DigitalOcean account, then the region, size and system. Tick your key and click Create server. The server appears online in about two minutes, once the agent has installed itself.
Verify it works
The server page shows Online and no blocker in the pre-flight checks. Sign in with ssh root@your-server-address using your key. The DigitalOcean control panel lists the droplet with the name you gave it.
Troubleshooting
- The token works for a list but creating fails
- The scope is too narrow. Generate a token with Full Access, or with Custom Scopes that include the Droplet actions, and connect the account again.
- Create server asks for a key
- Add a public key under Settings, then SSH keys, and tick it in the create form. DigitalOcean does not create droplets without a key.
- The droplet stays offline
- Check that the droplet can reach Zefily over outbound HTTPS and that it has at least 512 MB of memory and 2 GB of free disk. The server overview shows the pre-flight result.
Questions
Can I create a droplet without an SSH key?
No. DigitalOcean gives no initial password, so the key is the way you sign in. Zefily installs the keys you choose for root.
Is Full Access needed?
Full Access is the simplest choice. Custom Scopes work if they include the Droplet permissions; a Read Only token cannot create servers.
Where is the token kept?
In Zefily it is encrypted with your organization key and never shown again. Revoke it in DigitalOcean if you stop using Zefily.
Read next
Start on a server you own
Create your account, connect a server and follow the guide. The server stays yours: you pay your provider.