# Metalhost

> VM and bare-metal hosting for developers. Real cores, real disks, transparent pricing, no egress fees.

Each docs page is also served as Markdown at the same URL with a `.md` suffix:

```
curl https://metalhost.net/docs/developers/sdk.md
```

- [Documentation](https://metalhost.net/docs.md): Metalhost documentation — Dashboard guides and Developer docs for the CLI, Go SDK, and API.

## Dashboard

- [Dashboard](https://metalhost.net/docs/dashboard.md): Metalhost dashboard documentation — quickstart and guides for app.metalhost.net.
- [How it works](https://metalhost.net/docs/dashboard/overview.md): How Metalhost works in the dashboard — organizations, projects, wallet, VMs, bare metal, storage, and networking.
- [Quickstart](https://metalhost.net/docs/dashboard/quickstart.md): From signed up to a running Ubuntu VM with SSH access in the Metalhost dashboard.
- [Alerts & notifications](https://metalhost.net/docs/dashboard/guides/alerts.md): Create alert conditions, interpret open incidents, and configure email, chat or webhook notifications.
- [API keys](https://metalhost.net/docs/dashboard/guides/api-keys.md): Create and manage API keys in the Metalhost dashboard for CLI, SDK, and REST access.
- [Automation access](https://metalhost.net/docs/dashboard/guides/automation.md): Scoped keys, service accounts, GitHub connections, rotation and credential recovery.
- [Bare metal](https://metalhost.net/docs/dashboard/guides/bare-metal.md): Whole-host leases in the Metalhost dashboard — VMs vs bare metal, browse inventory, and when to pick a dedicated server.
- [Install ISOs](https://metalhost.net/docs/dashboard/guides/bare-metal-isos.md): Bare-metal ISO library in the Metalhost dashboard — upload or import install images, quota, and attach from console.
- [Lease bare metal](https://metalhost.net/docs/dashboard/guides/bare-metal-lease.md): Lease a dedicated server in the Metalhost dashboard — pick a host, OS, SSH access, public IPv4, and billing term.
- [Bare metal lifecycle](https://metalhost.net/docs/dashboard/guides/bare-metal-lifecycle.md): Manage a bare-metal lease in the dashboard — overview, console, network, power, reinstall, renew, and release.
- [Billing & usage](https://metalhost.net/docs/dashboard/guides/billing.md): Metalhost dashboard billing — overview, usage charts, network transfer, activity, invoices, limits, and payment settings.
- [Firewall rules](https://metalhost.net/docs/dashboard/guides/firewall.md): Open inbound ports from the internet to a VM's public IP. Default-deny posture, seeded SSH, source-CIDR scoping (v4 or v6), port ranges.
- [Team members](https://metalhost.net/docs/dashboard/guides/members.md): Invite and manage organization members in the Metalhost dashboard — roles, invites, and access.
- [VM monitoring](https://metalhost.net/docs/dashboard/guides/monitoring.md): Read VM charts, understand data quality, and install optional guest metrics.
- [VPC & private network](https://metalhost.net/docs/dashboard/guides/networks.md): Every Metalhost project is a private VPC — one L2 segment your VMs share. How the private network works, east-west traffic, and where public access lives.
- [Projects](https://metalhost.net/docs/dashboard/guides/projects.md): Create and manage Metalhost projects in the dashboard — workspaces for VMs, bare metal, storage, and keys.
- [Public IPv4](https://metalhost.net/docs/dashboard/guides/public-ipv4.md): How public IPv4 works on Metalhost: opt-in at create time, default-deny posture, $2/mo per address. Plus always-on public IPv6.
- [Public IPv6](https://metalhost.net/docs/dashboard/guides/public-ipv6.md): Every Metalhost VM gets a free, routable public IPv6 address by default. How it's allocated, how to reach your VM over v6, and how it's firewalled.
- [Security groups](https://metalhost.net/docs/dashboard/guides/security-groups.md): Segment your project's private network. Security groups are stateful allow-lists that gate VM-to-VM traffic, with rules sourced from CIDRs or other groups.
- [SSH keys](https://metalhost.net/docs/dashboard/guides/ssh-keys.md): Register reusable public keys per project and attach them to every VM you create — in the Metalhost dashboard.
- [Storage](https://metalhost.net/docs/dashboard/guides/storage.md): Block disks and NFS file shares in the Metalhost dashboard — create, attach, mount, and delete.
- [Support tickets](https://metalhost.net/docs/dashboard/guides/support.md): Open and manage support tickets in the Metalhost dashboard — org-wide billing, technical, and abuse requests.
- [Create a VM](https://metalhost.net/docs/dashboard/guides/vms-create.md): Step-by-step VM create in the Metalhost dashboard: region, CPU or GPU, size, OS image, login users, public IPv4, billing modes.
- [VM lifecycle](https://metalhost.net/docs/dashboard/guides/vms-lifecycle.md): After a VM is provisioned: start, stop, restart, resize, console, snapshot, clone, delete — from the dashboard.
- [Wallet & top-ups](https://metalhost.net/docs/dashboard/guides/wallet-topup.md): Funding your Metalhost account: card top-ups via Stripe, crypto top-ups via Coinbase (settled in USDC), auto-recharge, alerts, invoices.

## Developers

- [Developers](https://metalhost.net/docs/developers.md): Metalhost developer documentation — CLI, Go SDK, examples, and API reference.
- [Concepts](https://metalhost.net/docs/developers/concepts.md): Metalhost API concepts — resource names, authentication, operations, and the Connect HTTP protocol.
- [CLI quickstart](https://metalhost.net/docs/developers/quickstart.md): From install to a running Ubuntu VM with SSH — entirely from the metalhost CLI.
- [Examples](https://metalhost.net/docs/developers/examples.md): Copy-paste examples for common Metalhost tasks — CLI, Go SDK, and HTTP/JSON.
- [CLI — Getting started](https://metalhost.net/docs/developers/cli.md): Install and configure the metalhost CLI — init, profiles, global flags, operations, and topic guides.
- [Go SDK](https://metalhost.net/docs/developers/sdk.md): Build on Metalhost with the Go SDK — auth, Connect clients, VM manifests, operations, pagination, and a complete working program.
- [API reference](https://metalhost.net/docs/developers/api.md): Metalhost customer HTTP API reference, rendered from a checked-in OpenAPI snapshot.
- [Markdown pages](https://metalhost.net/docs/developers/markdown.md): Pull any Metalhost docs page as Markdown for a local agent or IDE — one URL per page.
- [API reference](https://metalhost.net/docs/developers/api-preview.md): The customer API reference moved to the current SDK v1.1.2 snapshot.
- [Monitoring & automation](https://metalhost.net/docs/developers/observability.md): Scoped service accounts, GitHub Actions identity, project metrics, Grafana, and infrastructure alerts.
- [CLI — Bare metal](https://metalhost.net/docs/developers/guides/cli-bare-metal.md): Metalhost CLI commands for bare-metal hosts — browse, lease, power, ISO library, and release.
- [CLI — Catalog, quotas & audit](https://metalhost.net/docs/developers/guides/cli-catalog.md): Datacenters, capacity, pricing quotes, quota usage, and audit events with the Metalhost CLI.
- [CLI — IAM, projects & orgs](https://metalhost.net/docs/developers/guides/cli-iam.md): Metalhost CLI commands for API keys, org members, projects, and identity.
- [CLI — Network & firewall](https://metalhost.net/docs/developers/guides/cli-network.md): Metalhost CLI commands for tenant networks and VM firewall rules.
- [CLI — Storage](https://metalhost.net/docs/developers/guides/cli-storage.md): Metalhost CLI commands for block disks and NFS file shares.
- [CLI — Support](https://metalhost.net/docs/developers/guides/cli-support.md): Open and manage support tickets with the Metalhost CLI.
- [CLI — VMs](https://metalhost.net/docs/developers/guides/cli-vms.md): Metalhost CLI commands for virtual machines — create, YAML manifests, lifecycle, snapshots, and SSH keys.
- [CLI — Wallet & billing](https://metalhost.net/docs/developers/guides/cli-wallet.md): Metalhost CLI commands for wallet balance, top-ups, usage, invoices, and auto-recharge.
- [CLI — Webhooks](https://metalhost.net/docs/developers/guides/cli-webhooks.md): Metalhost CLI commands for webhook subscriptions and delivery logs.
- [GitHub Actions](https://metalhost.net/docs/developers/guides/github-actions.md): Verify a workflow and exchange GitHub identity for short-lived, project-scoped Metalhost API access.
- [Operations & idempotency](https://metalhost.net/docs/developers/guides/operations-idempotency.md): Track long-running Metalhost mutations safely and retry requests without duplicating work.
- [Go SDK — Bare metal](https://metalhost.net/docs/developers/guides/sdk-bare-metal.md): Lease and manage bare-metal hosts with the Metalhost Go SDK — browse, quote, create, power, ISO library, and release.
- [Go SDK — Catalog & quotas](https://metalhost.net/docs/developers/guides/sdk-catalog.md): Datacenters, capacity, pricing quotes, quotas, and audit search with the Metalhost Go SDK.
- [Go SDK — IAM & API keys](https://metalhost.net/docs/developers/guides/sdk-iam.md): Authentication, API keys, and org membership with the Metalhost Go SDK.
- [Go SDK — Network & firewall](https://metalhost.net/docs/developers/guides/sdk-network.md): Tenant networks and VM firewall rules with the Metalhost Go SDK.
- [Go SDK — Storage](https://metalhost.net/docs/developers/guides/sdk-storage.md): Block disks and NFS file shares with the Metalhost Go SDK — create, attach, resize, and delete.
- [Go SDK — Support](https://metalhost.net/docs/developers/guides/sdk-support.md): Support tickets with the Metalhost Go SDK — create, list, reply, and close.
- [Go SDK — VMs](https://metalhost.net/docs/developers/guides/sdk-vms.md): Create and manage virtual machines with the Metalhost Go SDK — manifests, lifecycle, snapshots, SSH keys, and quoting.
- [Go SDK — Wallet & billing](https://metalhost.net/docs/developers/guides/sdk-wallet.md): Wallet balance, usage queries, top-ups, and billing configuration with the Metalhost Go SDK.
- [Go SDK — Webhooks](https://metalhost.net/docs/developers/guides/sdk-webhooks.md): Event webhooks with the Metalhost Go SDK — subscriptions, HMAC verification, and delivery logs.

## Optional

- [OpenAPI spec](https://metalhost.net/openapi.yaml): machine-readable API reference
- [HTML docs](https://metalhost.net/docs): human-readable documentation