gandi-cli🌍 Domains
List your registered domains and renew them from the terminal.
The gandi domain group manages your registered domains.
📋 List domains
Show every registered domain with its expiry date and status:
gandi domain listOutput is rendered as an aligned table, sorted and formatted for quick scanning.
Requires: the View and renew domains (domain:view) permission on your
token.
🔄 Renew a domain
Renew a domain for one year:
gandi domain renew example.comRenew for a specific number of years with --duration:
gandi domain renew example.com --duration 3Requires: the View and renew domains (domain:renew) permission on your
token.
ℹ️ Show domain details
Print a domain's status, registration dates, nameservers, and auto-renew state:
gandi domain info example.comRequires: the View and renew domains (domain:view) permission on your
token.
🔎 Check availability
Check whether a domain can be registered, along with its price:
gandi domain available example.com♻️ Toggle auto-renew
Turn automatic renewal on or off:
gandi domain autorenew example.com on
gandi domain autorenew example.com offRequires: the View and renew domains (domain:renew) permission on your
token.
🌐 Show nameservers
List the nameservers currently set for a domain:
gandi domain nameservers example.comRequires: the View and renew domains (domain:view) permission on your
token.
📖 Command reference
| Command | Description |
|---|---|
gandi domain list | List all domains with expiry dates and status |
gandi domain info <domain> | Show status, dates, nameservers, auto-renew |
gandi domain available <name> | Check whether a domain can be registered |
gandi domain renew <domain> | Renew a domain for 1 year |
gandi domain renew <domain> --duration <years> | Renew for a specified number of years |
gandi domain autorenew <domain> on|off | Turn auto-renew on or off |
gandi domain nameservers <domain> | Show the nameservers for a domain |
Not sure which commands your token can run? Use
gandi doctor to check your scopes.