• Don't have any browser to manage your domains, servers and so on?
• Want to automate/script some tasks?
• Want to quickly make some administrative jobs on a domain/server?

• Never ever install this tool on servers (dedicated as VPS) you rent to OVH
• I decline all responsabilities of the usage made of this tool, there is no warranty
• I'm not affiliated in any way to the OVH company

• cmake
• (a C compiler)

• openssl
• libcurl
• libxml2
• libedit (autocompletion)
• libiconv
• gettext (optional)

Clone/compile/install ovh-cli

git clone ...
cd <path/to/build/directory>
cmake <path/to/sources/directory> (-DCMAKE_INSTALL_PREFIX=/usr/local)
make
(sudo) make install

• OVH Europe
  • Create your application
  • Create all keys at once
• OVH North America
  • Create your application
  • Create all keys at once
• So you Start Europe
  • Create your application
  • Create all keys at once
• So you Start North America
  • Create your application
  • Create all keys at once
• Kimsufi Europe
  • Create your application
  • Create all keys at once
• Kimsufi North America
  • Create your application
  • Create all keys at once
• Runabove
  • Create your application
  • Create all keys at once

1. Create and register your application(s):

ovh application <endpoint (one of: kimsufi-ca, kimsufi-eu, ovh-ca, ovh-eu, runabove-ca, soyoustart-ca, soyoustart-eu)> add <application key> <application secret>

2. Register your account(s):
   • with your password instead of a valid consumer key: ovh account <nic-handle> add password <password> endpoint <endpoint (one of: kimsufi-ca, kimsufi-eu, ovh-ca, ovh-eu, runabove-ca, soyoustart-ca, soyoustart-eu)>
   • with a valid consumer key instead of a password (use link "Create all keys at once" above): ovh account <nic-handle> add password "" key <consumer key> expires in illimited endpoint <endpoint (one of: kimsufi-ca, kimsufi-eu, ovh-ca, ovh-eu, runabove-ca, soyoustart-ca, soyoustart-eu)> (if your consumer key is not unlimited, replace illimited by "X days")
   • without password or consumer key: ovh account <nic-handle> add password "" endpoint <endpoint (one of: kimsufi-ca, kimsufi-eu, ovh-ca, ovh-eu, runabove-ca, soyoustart-ca, soyoustart-eu)> and follow instructions to acquire a consumer key

• log <on/off> => enable/disable HTTP logging (file http.log in current directory)
• application
  • list => list all known OVH applications
  • <endpoint> (one of: kimsufi-ca, kimsufi-eu, ovh-ca, ovh-eu, runabove-ca, soyoustart-ca, soyoustart-eu)
    • add <application key> <application secret> => register an application for the given endpoint
    • delete => remove the application associated to endpoint
• account
  • list => list all known OVH accounts
  • <nic-handle>
    • add or update => register a new account or update an existant account named nic-handle
      • password <password or use empty string - "" - to not record it>
      • key <consumer key> expires in|at <expiration date or delay>)
      • endpoint <endpoint (one of: kimsufi-ca, kimsufi-eu, ovh-ca, ovh-eu, runabove-ca, soyoustart-ca, soyoustart-eu)>
    • delete => delete account
    • default => set default account to nic-handle
    • switch => change current account to nic-handle
• domain
  • check => list domains and when they expire
  • list => display all domains owned by the current account
  • <domain name> ("zone" may be more appropriate)
    • export => export domain/zone in DNS format
    • refresh => refresh domain (generation of a new serial)
    • dnssec
      • status => print if DNSSEC is enabled/disabled for domain
      • enable => enable DNSSEC for domain
      • disable => disable DNSSEC for domain
    • record ("subdomain" may be more appropriate) (TODO: find a more convenient way to manage empty subdomain name - SPF, NS, ... ?)
      • list => display all subdomains of domain
        • nocache => fetch data from OVH instead of using internel cache (avoid restarting ovh-cli shell)
        • type <one of: A, AAAA, CNAME, LOC, MX, NAPTR, NS, PTR, SPF, SRV, SSHFP, TXT> => list only records of the given type
      • <record name>
        • add <target> type <one of: A, AAAA, CNAME, LOC, MX, NAPTR, NS, PTR, SPF, SRV, SSHFP, TXT> => add subdomain to domain
        • delete => delete subdomain of domain (TODO: non unique subdomain names are all deleted)
        • update => update subdomain of domain (TODO: can only update subdomains which are not ambiguous)
          • ttl <ttl> => change TTL value (in minutes)
          • name <name> => rename subdomain
          • value <value> => alter value/target of subdomain
• dedicated
  • check => list servers and when they expire
  • list => list all servers associated to the current account
  • <server name>
    • reboot => hard reboot of server
    • boot
      • list => list all available boots for server
      • show => display current boot for server
      • <boot name> => set boot for next (re)boots of server
    • reverse
      • delete => remove reverse name of server
      • set <reverse> => define reverse name of server
• hosting
  • list => list all hosted website
  • <hosting>
    • user
      • list => list (FTP & SSH) users of hosting
      • <user>
        • delete => remove user from hosting
    • cron list => list cron jobs for hosting
    • domain
      • list => list domains associated to hosting
      • <domain>
        • delete => unlink domain to hosting
        • add <path> => link domain to hosting through path
    • database
      • list => list databases associated to hosting
      • <database>
        • delete => drop database associated to hosting
• credentials
  • list => list all credentials used to connect to any OVH application with current account
  • flush => remove all credentials used with current account
• key
  • list => list global SSH keys
  • <name>
    • delete => remove SSH key named name
    • add <ssh key> => register ssh key as name
    • default <on/off> => (un)define SSH key named name as default (default = the one used in rescue mode)
• me => display personal informations associated to the current account (name, address, etc)
• help
• quit

For partial bash completion (in current shell), run: source <(ovh complete)