Skip to content
zefıly

Connect a Vultr server to Zefily

Vultr keys have full access to the account, so this guide starts with the IP restriction. Then Zefily can create or import Vultr servers. Vultr can also create a server without a key, which shows a root password once.

Before you start

  • A Vultr account where you can open the API settings.
  • The IP address of the Zefily gateway. Zefily support confirms it if the connect form does not show it.
  • A Zefily account that can manage servers and integrations in the organization.

Steps

  1. 1. Open the API settings at Vultr

    In the Vultr customer portal open Account, then API in the OTHER section. This page holds the API key and the Access Control list.

  2. 2. Create an API key

    Create an API key in the provider's console on that page and copy it at once.

  3. 3. Restrict the key to the Zefily gateway

    In the Access Control section, enter the Zefily gateway IP address and click Add. Vultr keys have no scopes, so this list is what limits them to Zefily.

  4. 4. Add the key to Zefily

    In Zefily open Settings, then Cloud providers. Choose Vultr, give the account a name and paste the key. The key is verified when you connect it.

  5. 5. Choose how you sign in

    Put your key in the SSH key vault and tick it when you create the server. To create a server without a key, tick I do not want an SSH key; keep password login on. Zefily then shows the root password once, and does not keep it. Copy it at once; password login stays on until you add a key.

  6. 6. Create the server or import one

    Choose Servers, then Add server, pick the Vultr account, then the region, size and system, and click Create server. To use a server that already runs at Vultr, choose Import an existing one.

  7. 7. Wait for the agent

    The agent installs itself on the first boot, and the server shows Online in about two minutes. Read the pre-flight checks on the server overview before you install the web stack.

Verify it works

The server page shows Online and the pre-flight checks list no blockers. Sign in with ssh root@your-server-address using your key, or, when you used the password option, add a key first and then turn password login off from the server page.

Troubleshooting

Zefily cannot reach the Vultr API
The key is restricted to IP addresses, and the gateway address is missing from the Access Control list. Add it there, then check the account in Settings, then Cloud providers.
The root password dialog was closed
Zefily does not keep the password, so it cannot show it again. Reset the root password in the Vultr console, or add a key to the server and turn password login off.
A size or region is missing
Zefily lists the sizes that Vultr can deliver in a region right now, refreshed every ten minutes. Choose another region or size.

Questions

Why limit the key to an IP address?

A Vultr key can manage the whole account. An IP restriction makes a leaked key useless from anywhere else, which is why Vultr documents the Access Control list.

Is a server without an SSH key safe?

It is less safe. Password login is on until a key is added, so add a key and turn password login off as soon as the server is online.

Can I import a Vultr server I already run?

Yes. Choose Servers, then Add server, then Import an existing one. Then install the agent with the one-line command shown on the server page.

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 →