Skip to main content

​
Cloud hosting Introduction

Welcome to the HoganHost Cloud API.
This guide will walk you through authenticating, provisioning, and managing your servers programmatically. All API requests are made over HTTPS and must include your unique API key.

​
Authentication

Each request must include your API key in the Authorization header: 
curl -X GET "https://cloud.hoganhost.com/api/v1/servers"   -H "Authorization: Bearer YOUR_API_KEY"
If your key is missing or invalid, the API responds with an Unauthorized error.

​
Creating a Server

To provision a new server, use the POST /servers endpoint: 
curl -X POST "https://api.hoganhost.com.ng/api/v1/servers"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
        "name": "myserver",
        "plan": "s-1vcpu-1gb",
        "region": "nyc1",
        "image": "ubuntu-22-04-x64"
      }'

​
Field Reference

  • name – A human-friendly identifier for your server. This will also be used as the server’s hostname.
    Example: web-01, db-primary.
  • plan – Defines the server’s resources (CPU, RAM, disk).
  • region – The datacenter where your server will be deployed.
  • image – The operating system or application image installed.

​
Available Plans

SlugDescription
s-1vcpu-1gbStandard: 1 vCPU, 1 GB RAM
s-1vcpu-2gbStandard: 1 vCPU, 2 GB RAM
s-2vcpu-2gbStandard: 2 vCPU, 2 GB RAM
s-2vcpu-4gbStandard: 2 vCPU, 4 GB RAM
g-2vcpu-8gbGeneral Purpose: 2 vCPU, 8 GB RAM
g-4vcpu-16gbGeneral Purpose: 4 vCPU, 16 GB RAM
g-8vcpu-32gbGeneral Purpose: 8 vCPU, 32 GB RAM
g-16vcpu-64gbGeneral Purpose: 16 vCPU, 64 GB RAM
c-2Compute Optimized: 2 vCPU
c-4Compute Optimized: 4 vCPU
c-8Compute Optimized: 8 vCPU
c-16Compute Optimized: 16 vCPU
s-1vcpu-1gb-35gb-intelStandard (Intel): 1 vCPU, 1 GB RAM, 35 GB Disk
s-1vcpu-2gb-70gb-intelStandard (Intel): 1 vCPU, 2 GB RAM, 70 GB Disk
s-2vcpu-2gb-90gb-intelStandard (Intel): 2 vCPU, 2 GB RAM, 90 GB Disk
s-2vcpu-4gb-120gb-intelStandard (Intel): 2 vCPU, 4 GB RAM, 120 GB Disk
g-2vcpu-8gb-intelGeneral Purpose (Intel): 2 vCPU, 8 GB RAM
g-4vcpu-16gb-intelGeneral Purpose (Intel): 4 vCPU, 16 GB RAM
g-8vcpu-32gb-intelGeneral Purpose (Intel): 8 vCPU, 32 GB RAM
g-16vcpu-64gb-intelGeneral Purpose (Intel): 16 vCPU, 64 GB RAM
c-4-intelCompute Optimized (Intel): 4 vCPU
c-8-intelCompute Optimized (Intel): 8 vCPU
c-16-intelCompute Optimized (Intel): 16 vCPU
c-32-intelCompute Optimized (Intel): 32 vCPU

​
Available Regions

SlugLocationCountry
nyc1New York 1USA
nyc3New York 3USA
sfo2San Francisco 2USA
sfo3San Francisco 3USA
ams3Amsterdam 3Netherlands
sgp1Singapore 1Singapore
lon1London 1UK
fra1Frankfurt 1Germany
tor1Toronto 1Canada
blr1Bangalore 1India

​
Available Images

Below are common base and application images:
SlugDescription
ubuntu-24-04-x64Ubuntu 24.04 LTS (x64)
ubuntu-22-04-x64Ubuntu 22.04 LTS (x64)
ubuntu-20-04-x64Ubuntu 20.04 LTS (x64)
debian-12-x64Debian 12 (x64)
debian-11-x64Debian 11 (x64)
rockylinux-9-x64Rocky Linux 9 (x64)
rockylinux-8-x64Rocky Linux 8 (x64)
almalinux-8-x64AlmaLinux 8 (x64)
fedora-40-x64Fedora 40 (x64)
centos-7-x64CentOS 7 (legacy)
docker-20-04Docker on Ubuntu 20.04 (x64)

​
Best Practices

  • Use shutdown before power_off or delete for graceful termination.
  • Reserve reboot for controlled restarts rather than issue recovery.
  • Store and track your server_id for later operations.
  • Prefer LTS images for long-term stability and security.
  • Deploy servers in regions nearest to your end users for optimal latency.