Hello,
We have decided not to continue to maintain the CLI project. The existing project will remain as-is. Anyone interested in taking over and forking the project can let us know and we can inform our users and/or link to it.
If you have any questions, please feel free to contact our team.
Sincerely,
The Gandi.net team
Use $ gandi to easily create and manage web resources from the command line.
$ gandi domainto buy and manage your domain names$ gandi paasto create and deploy your web applications$ gandi vmto spin up and upgrade your virtual machines$ gandi certificateto manage your ssl certificates$ gandito list all available commands- Detailed examples
- All commands
- A compatible operating system (Linux, BSD, Mac OS X/Darwin, Windows)
- Python 2.7/3.4/3.5/3.6/3.7/3.8
- openssl
- openssh
- git
Recommended tools
- pip
- virtualenv
- docker
$ virtualenv /some/directory/gandi.cli
$ source /some/directory/gandi.cli/bin/activate
$ pip install gandi.cli
$ cd /path/to/the/repository
$ python setup.py install --user
$ ln -sf packages/debian debian && debuild -us -uc -b && echo "Bisou"
Using our classic (V4) website:
- To get started, you can create a free Gandi account and get your Gandi Handle
- Generate your Production API Token from the account admin section
- You may also want to top-up your prepaid account
- To manipulate VMs, you also need to purchase credits (you can use funds from your prepaid account)
Using our latest (V5) website:
- To get started, you can create a free Gandi account and get your Gandi username
- Generate your Production API Token from within the account Security section
- You may also want to top-up your prepaid account
- To manipulate VMs, you currently need to follow above steps to create an account on our classic (V4) website.
Then run the setup
$ gandi setup
> API Key: x134z5x4c5c # copy-paste your api key
> Environment [production] : # press enter for Production, the default
> SSH key [~/.ssh/id_rsa.pub] : # your SSH public key for hosting instances and servers
See the Advanced Usage section for more details on configuration.
- Registering a domain name
- Creating a virtual machine
- Deploying a web application with Simple Hosting
- Creating a SSL Certificate
- Adding a Web Application vhost with SSL
- Creating a Private VLAN
Gandi has been a domain name registrar since 1999. The oldest in France and one of the world's leading, Gandi is recognized for its No Bullshit™ trademark and approach to domain names.
You can now buy and manage domains in any of the 500+ TLD's that Gandi offers from the command line.
Learn more about Gandi Domains on the website.
$ gandi domain create
> Domain: example.com # enter the domain name here
> example.com is available
> Duration [1] : 1 # enter the duration in years
This will create a domain and use your default information for Ownership, Admin, Technical and Billing info.
$ gandi domain create --domain example.com --duration 1
$ gandi domain create --domain example.com --duration 1 --owner XYZ123-GANDI --admin XYZ123-GANDI --tech XYZ123-GANDI --bill XYZ123-GANDI
You can use the information of Gandi handles associated to Contacts in your account to setup Owner, Admin, Technical and Billing info.
$ gandi domain list
$ gandi domain info example.com
$ gandi record create example.com --name www --type A --value 127.0.0.1
Add a new record to the domain's current zone file and activate it.
$ gandi record list example.com
List a domain's zone file records. You can use the --format parameter to change the output format to text or json.
$ gandi record update example.com --record "@ 3600 IN A 127.0.0.1" --new-record "@ 3600 IN A 0.0.0.0"
This command is useful to update only one record at the time. The pattern to use is name TTL CLASS TYPE value.
You can easily check or copy-paste the values you need to replace using the --format text parameter:
$ gandi record list example.com --format text
$ gandi record list example.com --format text > file.zone
Use this command to extract your zone records into a file called file.zone (or something else).
Simply edit the file to your liking and then update the entire zone file with it.
$ gandi record update example.com -f file.zone
$ gandi record delete example.com --value 127.0.0.1
Delete all records that match the given parameters from a domain's zone file. In this example, if there were many records with '127.0.0.1' as their value, all of them would be deleted.
Gandi Server offers powerful Xen- and Linux-based virtual machines since 2007.
Virtual machines can be configured and upgraded on the fly to your liking. For example, you can start with 1GB of RAM, and run a command to add 2GB of RAM and 2 CPUs without even having to restart it.
Gandi Server measures consumption by the hour and uses a prepaid credit system. To learn more, check out the Gandi Server website.
$ gandi vm create
* root user will be created.
* SSH key authorization will be used.
* No password supplied for vm (required to enable emergency web console access).
* Configuration used: 1 cores, 256Mb memory, ip v4+v6, image Debian 8, hostname: temp1415183684, datacenter: LU
Create a virtual machine with the default configuration and a random hostname.
$ gandi vm update temp1415183684 --memory 2048 --cores 2
Set the VM's RAM to 2GB and add a CPU core on the fly.
$ gandi vm create --datacenter US --hostname docker --cores 2 --memory 3072 --size 10240 --image "Ubuntu 14.04 64 bits LTS (HVM)" --run "curl -sSL https://get.docker.com/ubuntu/ | sh"
* root user will be created.
* SSH key authorization will be used.
* No password supplied for vm (required to enable emergency web console access).
* Configuration used: 2 cores, 3072Mb memory, ip v4+v6, image Ubuntu 14.04 64 bits LTS, hostname: docker, datacenter: LU
This command will setup the above VM, and install docker by running curl -sSL https://get.docker.com/ubuntu/ | sh after creation.
$ gandi vm list
$ gandi vm info docker
Gandi Simple Hosting is a PaaS (Platform as a Service) offering fast code deployment and easy scaling, powering over 50,000 apps since its inception in 2012.
Instances can run apps in 4 languages (PHP, Python, Node.js and Ruby) along with one of 3 popular databases (MySQL, PostgreSQL and MongoDB) and operate on a managed platform with built-in http caching.
Plans cover all scales, from small to world-class projects. Check out the website for more information.
$ gandi paas create --name myapp --type nodejspgsql --size S --datacenter FR --duration 1
Simple Hosting offers two "modes": the App mode, where an instance offers a single git repository (default.git) and the Sites mode, where you can have multiple git repositories per instance (one for each VHOST, for example www.myapp.com.git).
Node.js, Python and Ruby instances run in App mode, whereas PHP instances run in Sites mode by default. Note: If you create a wildcard VHOST for your PHP instance, the App mode will be activated.
Assuming you have local directory called app where you have placed your code base, you can use the following commands to create a git remote (called "gandi" by default) and push your code.
$ cd app
$ gandi paas attach myapp # App mode
$ gandi paas attach myapp --vhost www.myapp.com # Sites mode
$ git push gandi master
Still inside the app folder, you can use the following command to start the deploy process, which will checkout your code, install dependencies and launch (or relaunch) the app process:
$ gandi deploy
Gandi SSL offers a range of SSL certificates to help you secure your projects.
You can order, obtain, update and revoke your certificates from the command line.
$ gandi certificate plans
Our Standard, Pro and Business plans offer different validation methods and guarantees. Each plan supports all or some of these types of certificates: single address, wildcard and/or multiple subdomains.
To discover our offering and find the right certificate for your project, compare our plans and try our simulator.
Gandi CLI can choose the right certificate type for you depending on the number of domains (altnames) you supply at creation time. You only need to set it if you plan on adding more domains to the certificate in the future.
WARNING: This command is billable.
To request a certificate, you need to use a private key to generate and sign a CSR (Certificate Signing Request) that will be supplied to Gandi.
The create command will take care of this for you if you don't have them already, or you can supply your CSR directly.
Check out the examples below or our wiki for more information on how SSL certificates work.
To create a single domain Standard certificate:
$ gandi certificate create --cn "domain.tld"
For a wildcard Standard certificate:
$ gandi certificate create --cn "*.domain.tld"
For a multi domain Standard certificate:
$ gandi certificate create --cn "*.domain.tld" --altnames "host1.domain.tld" --altnames "host2.domain.tld"
You can also specify a plan type. For example, for a single domain Business certificate:
$ gandi certificate create --cn "domain.tld" --type "bus"
If you have a CSR (you can give the CSR content or the path):
$ gandi certificate create --csr /path/to/csr/file
$ gandi certificate follow <operation_id>
As soon as the operation is DONE, you can export the certificate.
$ gandi certificate export "domain.tld"
You can also retrieve intermediate certificates if needed.
$ gandi certificate export "domain.tld" --intermediate
Find information on how to use your certificate with different servers on our wiki.
Gandi allows you to associate a certificate with your vhost.
Just create the vhost giving it the private key used to generate that certificate.
$ gandi vhost create domain.tld --paas "PaasName" \
--ssl --private-key "domain.tld.key"
#### 2. You have the matching certificate but not at Gandi (or in another account)
Declare the hosted certificate.
$ gandi certstore create --pk "domain.tld.key" --crt "domain.tld.crt"
And then create the vhost.
$ gandi vhost create domain.tld --paas "PaasName" --ssl
Create the certificate.
$ gandi certificate create --cn "domain.tld.key" --type std
And then create the vhost.
$ gandi vhost create domain.tld --paas "PaasName" \
--ssl --private-key "domain.tld.key"
You can use Gandi CLI to create and setup your private VLANs. For more detailed information on how VLANs and networking in general works at Gandi, please check out our resources:
$ gandi vlan create --name my-vlan-in-lu --datacenter LU \
--subnet "192.168.1.0/24" --gateway 192.168.1.1
To create a VLAN you need to determine its name and datacenter.
You can also set the subnet at creation time, or a default subnet will be chosen for you. The gateway setting is also optional and you can update both of these settings at any moment.
$ gandi vlan update my-vlan-in-lu --gateway 192.168.1.254
To add an existing VM to a VLAN, you can create a private network interface and attach it to the VM.
$ gandi ip create --vlan my-vlan-in-lu --attach my-existing-vm --ip 192.168.1.254
If you don't specify the IP you want to use, one will be chosen for you from the VLAN's subnet.
In fact there's no such thing as a "Private VM", but you can create a VM and only attach a private interface to it.
$ gandi vm create --hostname my-private-vm --vlan my-vlan-in-lu --ip 192.168.1.2
Please note that a private VM cannot be accessed through the emergency console. You'll need a public VM that also has a private interface on the same VLAN to gain access.
$ gandi vlan --help
Use the --help flag for more VLAN management options.
To list all available commands, type $ gandi --help
For extended instructions, check out the man page.
Install python-docutils and run:
$ rst2man --no-generator gandicli.man.rst > gandi.1.man
Then to read the manpage:
$ man ./gandi.1.man
Run $ gandi setup to configure your settings (see Getting started)
Use $ gandi config to set and edit custom variables.
The default variables are:
sshkey# path to your public ssh keyapi.host# the URL of the API endpoint to use (i.e. OTE or Production)api.key# the relevant API key for the chosen endpoint
We <3 contributions! See CONTRIBUTING.md for contribution guidelines.
You can check the contributors list.
Copyright © 2014-2018 Gandi S.A.S
Gandi CLI is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Gandi CLI is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Gandi CLI. If not, see http://www.gnu.org/licenses/gpl.txt.