Equinix Metal Provider
Equinix Metal API integration, setup, server plans, and locations.
Equinix Metal Provider
Overview
The Equinix Metal provider integrates with the Equinix Metal API for provisioning bare-metal servers in data centers worldwide. Equinix Metal offers true bare-metal performance with cloud-like provisioning speed, making it ideal for performance-critical production workloads.
Setup
1. Generate API Token
- Log in to the Equinix Metal Console
- Navigate to Personal API Keys
- Generate a new API key with appropriate permissions
2. Get Project ID
- In the console, select your project
- Copy the Project ID from the project settings
3. Configure AgentMetal
export EQUINIX_API_TOKEN=xxx
export EQUINIX_PROJECT_ID=xxx
Or in the configuration file:
providers:
equinix:
enabled: true
api_token: "xxx"
project_id: "xxx"
Server Plans
Equinix Metal uses "plans" instead of "types" to describe server configurations:
Compute-Optimized
| Plan | CPUs | RAM | Storage | Price/hr |
|---|---|---|---|---|
| c3.small.x86 | 8 cores | 32 GB | 480 GB SSD | ~$0.50 |
| c3.medium.x86 | 24 cores | 64 GB | 960 GB SSD | ~$1.00 |
| c3.large.arm | 80 cores | 256 GB | 2x480 GB SSD | ~$2.00 |
| Plan | CPUs | RAM | Storage | Price/hr |
|---|---|---|---|---|
| m3.small.x86 | 8 cores | 64 GB | 960 GB SSD | ~$0.75 |
| m3.large.x86 | 24 cores | 256 GB | 2x960 GB SSD | ~$2.00 |
| Plan | CPUs | RAM | Storage | Price/hr |
|---|---|---|---|---|
| s3.xlarge.x86 | 24 cores | 192 GB | 2x240 GB SSD + 12x8 TB HDD | ~$2.50 |
Equinix Metal operates in 25+ global metros:
| Metro | Code | Region |
|---|---|---|
| Washington, DC | dc | North America |
| Dallas | da | North America |
| Silicon Valley | sv | North America |
| New York | ny | North America |
| Amsterdam | am | Europe |
| Frankfurt | fr | Europe |
| London | ld | Europe |
| Singapore | sg | Asia Pacific |
| Sydney | sy | Asia Pacific |
| Tokyo | ty | Asia Pacific |
On-Demand Instances
Provision servers on-demand with per-hour billing. Servers are typically ready within minutes.
Reserved Instances
Reserve capacity for 1 or 3 year terms at discounted rates. Ideal for predictable production workloads.
Spot Instances
Use spare capacity at reduced rates. Spot instances can be reclaimed with short notice.
Networking
- Layer 2: VLAN-based private networking
- Layer 3: BGP for custom IP announcements
- Elastic IPs: Portable IP addresses across metros
- Global Anycast: Anycast IP addresses for global load balancing
Limitations
- Higher pricing compared to Hetzner and OVH
- Some plans have limited availability in certain metros
- Spot instances can be reclaimed during capacity shortages
- Reserved instances require upfront commitment