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 list

Output 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.com

Renew for a specific number of years with --duration:

gandi domain renew example.com --duration 3

Requires: 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.com

Requires: 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 off

Requires: 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.com

Requires: the View and renew domains (domain:view) permission on your token.

📖 Command reference

CommandDescription
gandi domain listList 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|offTurn 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.

On this page