Manage Your Servers

Bare metal. Instant provisioning. Unlimited containers.

Hoody gives you physical servers with the automation of virtual machines - the best of both worlds.

The Hoody Server Model

Traditional hosting forces a choice: Fast provisioning (VPS) OR Physical control (bare metal). Hoody provides both.

What You Get:

Bare metal servers - Full physical machine, no noisy neighbors, complete isolation
Instant provisioning - 1-5 minutes from click to ready (unprecedented for bare metal)
Fair pricing - Competitive rates for dedicated hardware
Reliable infrastructure - Carefully selected datacenters worldwide
Infinite containers - One server → hundreds of isolated containers

Why This Matters:

The container revolution promised infinite isolated environments, but traditional VPS hosting charges per VM. Hoody flips the model: rent one physical server, spawn unlimited containers.

Traditional VPS:          Hoody Bare Metal:
Per-VM monthly fee       One server rental
Multiple VMs needed      Unlimited containers
Expensive at scale       Cost-effective scaling

Managed Infrastructure Model

You control the containers. Hoody manages the host.

Unlike traditional bare metal where you install and maintain the OS, Hoody servers come fully managed:

What Hoody Manages:

Host operating system (cannot be modified or customized)
Container runtime and infrastructure
Security updates and patches
Hardware health monitoring
Platform service updates
Automatic failover and recovery

What You Control:

All containers and their configurations
Container OS choices and customization
Network rules and firewall settings
Storage organization and shares
Resource allocation across containers

Why This Matters:

No SSH access to bare metal host means:

Zero maintenance burden on you
Guaranteed platform compatibility
Automatic security updates
Consistent performance across all servers
Hoody ensures optimal container runtime

You get bare metal benefits (isolation, performance) without bare metal complexity.

How Server Management Works

1. Browse Available Servers

Hoody maintains a marketplace of instantly-available bare metal servers across multiple datacenters.

Browse by:

Location (country, region, city)
Specifications (CPU, RAM, storage)
Pricing tiers (duration-based discounts)

See: Rent Servers →

2. Rent Instantly

Click rent → Server provisioning begins → 1-5 minutes → Deploy containers.

No:

❌ Manual setup required
❌ Weeks of waiting
❌ Hardware configurations
❌ Commitment contracts

Yes:

✅ Automated provisioning
✅ Production-ready instantly
✅ Flexible rental periods
✅ Cancel anytime

3. Organize with Pools

Group servers into Pools for team access and organization.

Default Pool: Your personal servers
Custom Pools: Shared team servers with role-based access

See: Share Servers →

4. Deploy Unlimited Containers

Once you have a server, spawn containers without limits or per-container costs.

Capacity depends on:

Container resource requirements (CPU, RAM, storage)
Workload types (lightweight vs. heavy)
Server specifications (varies by marketplace offering)
Dynamic resource sharing across containers

Browse marketplace to see server specs and estimate container capacity.

API Endpoints Summary

Server management uses these APIs:

Server Management API

GET /api/v1/pools - List your pools and their servers
POST /api/v1/pools - Create pools for team organization
GET /api/v1/servers/available - Browse marketplace
POST /api/v1/servers/{id}/rent - Rent a server
GET /api/v1/servers/{serverId}/available-commands - List executable commands
POST /api/v1/servers/{serverId}/execute-command - Run commands on server

Wallet API

Manage balance for server rentals
View transaction history
Handle payments

The Bare Metal Advantage

Why Hoody uses bare metal servers:

Security Through Physical Isolation

Your containers run on hardware you control:

No shared hypervisor with strangers
No virtual partition vulnerabilities
Complete physical separation
Zero trust in shared infrastructure

Critical for:

AI-generated code you can’t fully audit
Client data isolation (agencies, consultancies)
Compliance requirements (GDPR, HIPAA)
Zero-knowledge architecture

Performance Predictability

No “noisy neighbor” problems:

100% of CPU/RAM/storage is yours
Consistent, predictable performance
No resource contention
Full disk I/O bandwidth

Economic Transformation

The VPS model is dead for container workloads:

Agency with multiple clients, multiple environments each

Traditional VPS:
Separate VM per environment = High monthly costs per client

Hoody Bare Metal:
Few servers, unlimited containers = Massive cost reduction
Plus: Unlimited additional containers for experiments

Instant Provisioning: The Game Changer

This is Hoody’s killer infrastructure advantage.

Most bare metal requires:

Days to weeks provisioning time (typically 1-7 days)
Manual configuration and OS installation
Long-term contracts
Complex setup and maintenance

Hoody bare metal:

< 1-5 minutes from rent to ready
Fully automated provisioning
Production-ready immediately
Cancel anytime

Why This Enables Automation:

When infrastructure materializes in minutes, AI can manage it directly:

// AI agent conversation becomes infrastructure
User: "I need a staging environment for client demo"

AI: *Rents server via API, 3 minutes later*
    "Staging server ready: https://client-demo.hoody.icu"
    "Containers deployed: frontend, backend, database"
    "Mock data populated. Demo URL: ..."

Bare metal with VPS-feel unlocks AI-driven infrastructure.

Server Locations

Hoody servers available in reliable datacenters worldwide. Browse current locations and availability via the Servers API marketplace.

Location selection considerations:

Choose datacenters closest to your users for lowest latency
Consider data residency requirements for compliance
Multiple regions available for geographic redundancy

Need a specific location? Contact support for custom datacenter requests or check the marketplace for currently available regions.

How to choose:

Place servers closest to your users (minimize latency)
Consider data residency requirements (compliance)
Use multiple regions for redundancy

Viewing Your Servers

# List all your pools and their servers
hoody pools list

# Get details for a specific pool
hoody pools get $POOL_ID

# Browse marketplace for new servers
hoody servers marketplace

# Execute a command on your server
hoody servers exec $SERVER_ID \
  --command-slug "system-stats" \
  --wait

import { HoodyClient } from '@hoody-ai/hoody-sdk';

const client = new HoodyClient({ baseURL: 'https://api.hoody.icu', token: process.env.HOODY_TOKEN });

// List all pools
const pools = await client.api.pools.list();

// Get pool details
const pool = await client.api.pools.get(poolId);

// Browse marketplace
const available = await client.api.serverRental.browse();

// Execute a server command
const result = await client.api.serverCommands.execute(serverId, {
  command_slug: 'system-stats',
  wait: true,
});

# List all pools
curl "https://api.hoody.icu/api/v1/pools" \
  -H "Authorization: Bearer $HOODY_TOKEN"

# Get pool details
curl "https://api.hoody.icu/api/v1/pools/$POOL_ID" \
  -H "Authorization: Bearer $HOODY_TOKEN"

# Browse marketplace
curl "https://api.hoody.icu/api/v1/servers/available" \
  -H "Authorization: Bearer $HOODY_TOKEN"

# Execute a server command
curl -X POST "https://api.hoody.icu/api/v1/servers/$SERVER_ID/execute-command" \
  -H "Authorization: Bearer $HOODY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command_slug": "system-stats", "wait": true}'

List All Your Pools and Servers

View all pools you own or are a member of:

GET List all pools you own or are a member of

/api/v1/pools

Click "Run" to execute the request

Response shows:

All pools you have access to (owned or member)
Your role in each pool (owner or member)
Number of servers in each pool
Member count

View Specific Pool Details

Get detailed information about a pool:

GET Get detailed information about a pool

/api/v1/pools/{poolId}

Click "Run" to execute the request

Response includes:

Complete pool information
List of all servers assigned to pool
All pool members and their roles
Pool settings and quotas

Server Details

Browse available servers in the marketplace:

GET List available servers for rental

/api/v1/servers/available

Click "Run" to execute the request

Shows server locations, specifications, pricing, and availability.

Executing Server Commands

Hoody provides predefined commands for server operations - maintenance, backups, monitoring, etc.

List Available Commands

See what commands can run on your server:

GET List available commands for a server

/api/v1/servers/{serverId}/available-commands

Click "Run" to execute the request

Filter by:

category - maintenance, backup, monitoring, etc.
risk_level - low, medium, high, critical

Execute a Command

Run predefined commands on your servers:

POST Run predefined commands on your servers

/api/v1/servers/{serverId}/execute-command

Click "Run" to execute the request

Command Execution:

Commands are predefined and safe (you can’t SSH to host)
Risk levels protect against dangerous operations
High/critical risk commands require confirmation tokens
Results returned immediately or via status polling

Common Commands:

System statistics and health checks
Container resource monitoring
Storage usage reports
Network diagnostics
Log retrieval

See Server Management API for complete command catalog.

Monitoring Server Status

Track your server health and usage:

Resource Monitoring

Check CPU, RAM, storage, network usage:

Via Hoody dashboard (visual graphs)
Via API (programmatic access)
Via server commands (on-demand reports)

Container Distribution

View containers per server:

List all containers on a server
See resource usage per container
Identify heavy vs. light workloads
Rebalance if needed

Rental Status

Track rental lifecycle:

Active rental period
Expiration date
Days remaining
Grace period status

Renewal Management:

Set calendar reminders for expiration
Monitor via API or dashboard
Renew before expiration to avoid data loss

Rental Model

Duration-Based Pricing:

Servers can be rented for as little as 1 day, with automatic discounts for longer periods. Longer rentals provide better rates.

Available durations vary by marketplace offer - check current options when browsing servers.

Flexible Terms:

No long-term contracts
Grace period after expiration (hold period)
Renew anytime during hold to avoid data loss
Manual renewal required before expiration

Payment:

Deducted from general balance (see Wallet)
Automatic billing on rental
Transparent invoicing

Use Cases

Solo Developer

Rent 1 server for all projects
Run dozens of containers (personal + client work)
Each project: dev, staging, prod environments
AI experimentation playground

Small Team (5-10 people)

Rent 2 servers
Organize into pools for team access
Many containers across all team projects
Shared resources, isolated projects

Digital Agency

Rent multiple servers
One pool per major client (perfect isolation)
High container density per server
Transparent per-client billing

Enterprise Development

Rent 10+ servers distributed globally
Production, staging, development separated
Hundreds or thousands of containers
Geographic redundancy and compliance

Best Practices

Server Selection:

Start with mid-tier server, monitor usage first month
Upgrade only when consistently hitting >80% resource usage
Don’t over-provision speculatively

Organization:

Use pools to group related servers (team, client, environment)
Name servers clearly (purpose, location, tier)
Document which containers run on which servers

Cost Management:

Monitor container density - are you utilizing the server?
Delete unused containers to free resources
Use snapshots instead of keeping idle containers running
Consolidate low-usage containers to fewer servers

Security:

Separate production from development servers
Use different pools for different clients/teams
Enable appropriate firewall rules per server
Rotate credentials regularly

Performance:

Place latency-sensitive containers on servers closest to users
Group communicating containers on same server
Monitor resource usage and rebalance as needed

Useful Questions

How long does server provisioning really take?

Typically 2-5 minutes, sometimes under 1 minute. This is unprecedented for bare metal - most providers take 1-7 days for provisioning. Hoody maintains a pool of ready-to-provision hardware across datacenters for instant availability.

What if I need more than what’s in the marketplace?

Contact support with your requirements (location, specs, quantity). We work with reliable datacenter partners and can provision custom configurations, though it may take longer than instant marketplace rentals.

Can I have servers in multiple regions?

Yes! Rent servers in different locations as needed. Containers on different servers communicate via their public URLs (through Hoody Proxy). Use Realms to isolate API visibility/control across environments, tenants, or automation.

What happens when my rental expires?

You enter a hold period (grace period) where the server remains active but you’re prompted to renew. If you renew during this time, no data is lost. After the hold period, the server is deprovisioned and data is deleted.

Can I move containers between servers?

Yes, through container copy/sync. You can copy or move containers from one server to another, preserving all state, files, and configuration.

How do I know which server a container is running on?

Container URLs include the server identifier. The Hoody dashboard also shows server assignments. You can manage this through the API or UI.

What’s included in server rental cost?

Everything: hardware, bandwidth, storage, automated management, updates, monitoring, and support. No hidden fees, no bandwidth overages, no storage tiers. One price, unlimited containers.

Troubleshooting

Server Provisioning Takes Longer Than 5 Minutes

Cause: High demand in specific datacenter or rare hardware allocation delay

Solution: Check dashboard for status updates. Provisioning rarely exceeds 10 minutes. If > 15 minutes with no progress, contact support - provisioning may be retrying automatically.

Can’t Spawn Containers on Server

Cause: Server still completing post-provisioning setup, or resource exhaustion

Solution: Wait 1-2 more minutes for complete initialization. Check server resource usage in dashboard. If server shows “ready” and resources available but containers won’t spawn, check error logs or contact support.

Server Performance Degraded

Cause: Too many containers or resource-heavy workloads

Solution: Check resource usage in dashboard. Identify resource-heavy containers. Consider: setting resource limits on specific containers, moving some containers to another server, or upgrading to higher-tier server.

Payment Declined During Rental

Cause: Insufficient balance or payment method issues

Solution: Add funds to your general balance via Wallet. Ensure payment method is valid and not expired. Rental will retry automatically once balance is sufficient.

Lost Access to Server After Expiration

Cause: Hold period ended, server deprovisioned

Solution: If still within hold period, renew immediately to restore access. If already deprovisioned, server and data are gone. Always set calendar reminders for critical server renewals.

What’s Next

Ready to rent your first server?

Rent Servers → - Browse marketplace and provision instantly

Need team collaboration?

Share Servers → - Organize servers with Pools

Understand the foundation:

Projects & Containers → - What runs on servers
Server Management API → - Full API reference
Wallet → - Manage billing and payments