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. 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. Create an API key
Create an API key in the provider's console on that page and copy it at once.
-
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. 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. 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. 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. 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.