{"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":"2026-05-26T11:51:18","modified_gmt":"2026-05-26T11:51:18","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>

Step 1 – Download & Install the CLI<\/b><\/code><\/h2>
    \n
  1. Install Go and clone the repository:\n
    apt install golang-go\r\n\r\ngit clone --depth 1 https:\/\/github.com\/hostinger\/api-cli \/tmp\/api-cli<\/pre>\n<\/li>\n
  2. Navigate into the project folder:\n
    cd \/tmp\/api-cli<\/pre>\n<\/li>\n
  3. Build the binary and move it to your system path:\n
    go build -o \/usr\/local\/bin\/hapi \r\n\r\nchmod 0755 \/usr\/local\/bin\/hapi<\/pre>\n<\/li>\n
  4. Return to your home directory and verify the installation:\n
    cd ~\r\n\r\nhapi --help<\/pre>\n<\/li>\n
  5. If `hapi –help` returns the command list, the CLI is installed correctly.<\/li>\n<\/ol>
    Step 2 – Authenticate with Your API Token<\/b><\/h2>
    Generate your API token at https:\/\/hpanel.hostinger.com\/api.<\/p>
    You can pass credentials either through a config file or environment variables.<\/p>
    Option A – Config file (persistent)<\/h3>
    wget https:\/\/raw.githubusercontent.com\/hostinger\/api-cli\/main\/hapi.yaml -O ~\/.hapi.yaml<\/pre>
      \n
    1. Edit the file and paste your token under api_token.<\/li>\n
    2. Run any command – the CLI will automatically read ~\/.hapi.yaml.<\/li>\n<\/ol>
      Option B – Environment variable (current session only)<\/h3>
      export HAPI_API_TOKEN=<paste_your_token_here><\/pre>
      Note<\/strong>: this resets when you close the terminal. Use Option A for a permanent setup.<\/div>
      Step 3 – Working with VPS Instances<\/b><\/h2>
      The vps sub-command groups everything related to virtual machines:<\/p>
      hapi vps vm list                 # List all VPS\r\nhapi vps vm get    <vm_id>       # Detailed info for one VPS\r\nhapi vps vm start  <vm_id>       # Power-on\r\nhapi 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>
      Official documentation<\/b><\/h2>
      API reference – https:\/\/developers.hostinger.com<\/a>
      \n​<\/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":2,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/292\/revisions"}],"predecessor-version":[{"id":10921,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/292\/revisions\/10921"}],"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}]}}