Vultr Setup

This page mirrors the gibil init Vultr branch. Use it if you're configuring Vultr non-interactively (CI scripts, headless installs) or if you just prefer to read along while you set things up.

New to Vultr? Sign up via this link to get $300 in free credits — enough for weeks of Gibil usage on small VMs.

Referral link — Gibil gets a kickback that helps fund development.

Open the API access page

→ console.vultr.com/user/apiaccess

You can also reach it via the Account menu in the top-right.

Whitelist your IP

This is the #1 reason a freshly-created Vultr API key appears "broken." Vultr blocks all API requests until you whitelist an IP under Access Control.

Scroll to Access Control on the API access page, then either:

Add your current IP: the most secure option. Find your IP at whatismyip.com if you don't already know it.
Or add 0.0.0.0/0: allows any IP. Fine for personal use, less secure.

Click Update Access Control to save.

Copy your API key

Scroll to the top of the page. Your Personal Access Token is the long string at the top. Click the eye icon to reveal it, then copy it to your clipboard.

Configure gibil

Interactive:

gibil init --add vultr

Non-interactive:

gibil init --provider vultr --token $VULTR_API_KEY

Or set the env var directly; the CLI picks it up automatically:

export VULTR_API_KEY=your_token_here
gibil create --provider vultr --location nrt --size small --ttl 15

If validation fails with 401

The most common cause is the IP whitelist. Re-open console.vultr.com/user/apiaccess, confirm your IP is listed under Access Control, and try again.

What's next

Run your first VM: five-minute walkthrough with gibil create
gibil create reference: full flag list, location codes, and the small/medium/large size catalog

APAC regions Vultr exposes through Gibil: Tokyo (nrt), Seoul (icn), Singapore (sgp), Sydney (syd), Mumbai (bom). Pass any of these as --location <code> to gibil create. Run gibil providers to print the full live catalog.