{"id":292,"date":"2025-06-30T09:28:50","date_gmt":"2025-06-30T09:28:50","guid":{"rendered":"https:\/\/blog.hostinger.io\/support\/2025\/06\/30\/11679133-how-to-use-hostinger-api-cli\/"},"modified":"2025-06-30T09:28:50","modified_gmt":"2025-06-30T09:28:50","slug":"11679133-how-to-use-hostinger-api-cli","status":"publish","type":"post","link":"https:\/\/www.hostinger.com\/support\/11679133-how-to-use-hostinger-api-cli\/","title":{"rendered":"How to Use Hostinger API CLI"},"content":{"rendered":"

A quick, step-by-step guide to install the Hostinger-API Command-Line Interface, connect it to your account, and run the most common VPS commands.<\/p>

\n<\/p>

Step 1 – Download & Install the CLI<\/b><\/h2>

Please change the version inside this code provided below. You can check for the latest CLI releases and versions here<\/a>.<\/p>

\n<\/p>

cd ~
wget https:\/\/github.com\/hostinger\/api-cli\/releases\/download\/<version>\/hapi-<version>-linux-amd64.tar.gz
tar -xf hapi-<version>-linux-amd64.tar.gz
sudo mv hapi \/usr\/local\/bin<\/code><\/pre>
\n
On macOS<\/b> download the file ending with darwin-amd64.tar.gz.<\/p>\n<\/div>
\n<\/p>
Step 2 – Authenticate with Your API Token<\/b><\/h2>
You can pass credentials either through a config file or<\/i> environment variables.<\/p>
\n<\/p>
Option A – Config file<\/b><\/h3>
wget https:\/\/raw.githubusercontent.com\/hostinger\/api-cli\/main\/hapi.yaml -O ~\/.hapi.yaml<\/code><\/pre>
    \n
  1. \n
    Edit the file and paste your token under api_token.<\/p>\n<\/li>\n
  2. \n
    Run any command – the CLI will automatically read ~\/.hapi.yaml.<\/p>\n<\/li>\n<\/ol>
    Option B – Environment variable (quick method)<\/b><\/h3>
    export HAPI_API_TOKEN=<paste_your_token_here><\/code><\/pre>
    \n<\/p>
    Every key from the YAML file can be supplied the same way by prefixing it with HAPI_<\/code> and capitalising the key name.<\/p>
    \n<\/p>
    Step 3 – Verify the Installation<\/b><\/h2>
    hapi --help<\/code><\/pre>
    \n<\/p>
    Step 4 – Working with VPS Instances<\/b><\/h2>
    The vps sub-command groups everything related to virtual machines:<\/p>
    \n<\/p>
    hapi vps vm list                 # List all VPS
    hapi vps vm get    <vm_id>       # Detailed info for one VPS
    hapi vps vm start  <vm_id>       # Power-on
    hapi vps vm stop   <vm_id>       # Graceful shutdown<\/code><\/pre>
    Use --format json<\/code> to pipe data into scripts or dashboards.<\/p>
    \n
    Tip:<\/b> The CLI mirrors Hostinger API endpoints, so everything you can do in developers.hostinger.com<\/i> is possible via hapi.<\/p>\n<\/div>
    \n<\/p>
    Official documentation<\/b><\/h2>
    API reference – https:\/\/developers.hostinger.com<\/a>
    ​<\/p>
    You’re all set!<\/b><\/h2>
    You can now automate routine VPS tasks, integrate Hostinger operations into CI\/CD pipelines, or simply manage servers faster from your terminal. Happy scripting! 🎉<\/p>\n","protected":false},"excerpt":{"rendered":"
    Quick guide on how to install and use Hostinger API CLI.<\/p>\n","protected":false},"author":581,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"include_on_kodee":true,"footnotes":""},"categories":[295],"tags":[],"class_list":["post-292","post","type-post","status-publish","format-standard","hentry","category-api"],"hreflangs":[{"locale":"en-US","link":"https:\/\/www.hostinger.com\/support\/11679133-how-to-use-hostinger-api-cli\/","default":1}],"include_on_kodee":true,"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/292","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/users\/581"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/comments?post=292"}],"version-history":[{"count":0,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/292\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/media?parent=292"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/categories?post=292"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/tags?post=292"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}