Skip to content
zefıly

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. 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. 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. 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. 4. Copy the token now

    Click Generate Token and copy the secret at once. DigitalOcean shows it only once.

  5. 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. 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. 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.

Start free

Black Friday & Cyber Monday

Before you go: lifetime plans are on sale

Pay once for a lifetime plan, or get 30% off the first year of any yearly plan.

Only 100 lifetime plans per plan. When they are gone, they are gone.

See the campaign

Amazing November

See the campaign →