Servers

Fugoku offers bare metal servers and virtual machines through the Latitude-style server model. Servers provide dedicated hardware with full IPMI access.

What Are Servers?

Servers in Fugoku are Latitude-aligned bare metal or virtual machine instances. They provide dedicated hardware resources with:

• IPMI-based remote management
• Rescue mode for recovery
• Multiple OS options
• Flexible billing (hourly, monthly, yearly)

Server Plans

Server plans are defined in the server catalog. Each plan specifies CPU, RAM, disk, and network resources.

Plan Categories

Example Plans

Operating Systems

Regions

Server Lifecycle

1. Creating

Server is being provisioned on the hardware. OS is being installed.

2. Active

Server is running and accessible. You can SSH in and use it.

3. Stopping

Server is being shut down gracefully.

4. Stopped

Server is powered off. You can restart it.

5. Maintenance

Server is undergoing maintenance (firmware updates, hardware repairs).

6. Terminating

Server is being decommissioned. Data will be erased.

7. Terminated

Server has been fully terminated.

IPMI Rescue Mode

IPMI provides out-of-band management for servers. Use rescue mode when SSH is unavailable.

Accessing IPMI

1. Navigate to Servers → Select Server → Overview
2. Find the IPMI connection details
3. Use the IPMI IP address and credentials to connect

Rescue Mode

1. Power off the server via IPMI or Console
2. Boot into rescue mode
3. Access the server's filesystem
4. Fix the issue (e.g., restore from snapshot, fix network config)
5. Reboot into normal mode

SSH Key Management

Servers use SSH keys for access. Keys are associated with providers and can be used across multiple servers.

Key Formats

• RSA (2048-bit or 4096-bit)
• Ed25519
• ECDSA (256-bit or 521-bit)

Default Users

Servers vs. Virtual Machines

Creating a Server

Via Console

1. Navigate to Servers
2. Click Create Server
3. Choose category (Bare Metal, Bare Metal GPU, Virtual Machine)
4. Select region, image, and plan
5. Configure SSH keys, tags, and billing
6. Click Create

Via API

curl -X POST https://api.fugoku.com/v1/servers \
  -H "Authorization: Bearer $FUGOKU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "servers",
      "attributes": {
        "name": "my-server",
        "hostname": "my-server.example.com",
        "project": "proj-abc",
        "site": "NYC",
        "plan": "rs4.metal.large",
        "operating_system": "ubuntu-24.04",
        "billing": "hourly",
        "ssh_keys": ["key-abc123"]
      }
    }
  }'

Backups

Both bare metal servers and virtual machines support backups.

Creating Backups

Console: Server detail → Backups tab → Create backup

API:

# For bare metal servers
curl -X POST https://api.fugoku.com/v1/servers/srv-abc123/backups \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "backups",
      "attributes": {
        "name": "backup-before-upgrade"
      }
    }
  }'

# For virtual machines
curl -X POST https://api.fugoku.com/v1/servers/srv-abc123/backups \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "backups",
      "attributes": {
        "name": "backup-before-upgrade"
      }
    }
  }'

Restoring Backups

Restoring a backup creates a new server or instance from the backup data. The original backup is archived.

curl -X POST https://api.fugoku.com/v1/backups/backup-abc123/restore \
  -H "Authorization: Bearer $TOKEN"

Deleting Backups

curl -X DELETE https://api.fugoku.com/v1/backups/backup-abc123 \
  -H "Authorization: Bearer $TOKEN"

Next Steps

• API Reference — Server API endpoints
• SSH Keys — Key management
• Jobs — Async provisioning and job tracking