On Demand

COMMAND LINE

Copy to clipboard

On Demand

Equinix Metal™ offers servers on an on-demand basis. You can provision and deprovision on demand servers to suit your workload's needs.

Availability and Cost

Equinix Metal has many types servers that are eligible for On Demand deployment -- availability permitting. Since we do not virtualize our infrastructure and provide 100% dedicated machines, there is the potential that not all server types will always be available at every location. Available inventory is not guaranteed for on-demand instance provisioning requests. If you need more reliable provisioning options, please look into ordering Reserved Hardware.

On demand servers are charged a fixed-rate per hour. Billing begins as soon as the server is successfully provisioned, and ends when the server has been deleted from the user's project.

Deploying On Demand Servers

Log into your Equinix Metal account at console.equinix.com/metal and navigate to the Servers page. To spin up a new server, click + New Server. Next, choose On Demand.

Deploying a new server options in the console

You will be able to select your Metro and, based on the capacity in the Metro, your server type. The server options list the hardware type, price her hour, and specs of each server class.

Location and Server options in the console

Next, choose an Operating System. Depending on the hardware, Equinix Metal supports a large amount of OSes. Custom OS images and custom iPXE images are also supported.

Operating Systems options in the console

If you want to deploy more than 1 server, you can adjust the number under Select Number. You can name your servers by changing the pre-filled hostnames. NOTE: You cannot use underscores in your hostname.

There are some optional settings if you need to configure user data, IP addresses, or SSH key access for your servers.

Additional provisioning options in the console

Your choices will be summarized in the Summary table. Once you are happy with the summary, you can deploy your server with the Deploy Now button.

Order Summary in the console

You can deploy a server with a single POST to the projects/{id}/devices endpoint of the Equinix Metal API.

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/devices" \
-d '{
    "metro": "<metro_code>",
    "plan": "<server_type>",
    "operating_system": "<os_code>"
}'

Your project ID is required in the request path. The body parameters metro, plan, and operating_system are all required. Optional fields include hostname, ip_addresses, userdata, and many others are available to further configure your servers. A complete listing and explanation of all the fields available is in the API Reference.

Similar to the API, you can deploy an on demand server with a single command in the Equinix Metal CLI.

packet device create --project-id <project_UUID> --plan <server_type> --metro <metro_code> --operating-system <os_code>

Your project ID is one of the required flags. The other required flags are --metro, --plan, and --operating_system. Optional flags include --hostname and --userdata. Many others are available to further configure your servers. A complete list of flags and their short codes is available in the CLI Reference.

Deleting an On Demand Server

Server instances deployed on demand are never deleted by Equinix Metal without explicit permission from the instance owner, except in the event of account termination or indefinite restriction due to failure to comply with our Terms of Service.

Please keep in mind that deleting a server is a permanent action. Once you delete a server, it becomes unrecoverable.

To delete a server from the console, navigate to the Servers page. Click the three dots for the Actions menu, and click Delete from the drop-down.

Deleting a Server

You will get a confirmation page to ensure that you would like to delete. Fill it out and click Delete Instance to remove the server.

To delete a server in the API, send a DELETE request to the /devices/{id} endpoint.

curl -X DELETE -H 'X-Auth-Token: <API_TOKEN>' \
"https://api.equinix.com/metal/v1/devices/{id}"

Once the request is received by the API, the server will be deleted. There is no confirmation step.

Frequently
asked questions

Slack

Still stuck?

Join us on Slack

Get support from our team and community members.

Frequently asked questions

What 3rd party Managed Services?

Neutra trust fund narwhal, palo santo bicycle rights live-edge stumptown health goth portland selfies kinfolk woke. ssss Echo park irony artisan vaporware typewriter. Next level pinterest drinking vinegar lyft mumblecore af small batch heirloom VHS. Fixie banh mi asymmetrical trust fund.

What 3rd party Managed Services?

Neutra trust fund narwhal, palo santo bicycle rights live-edge stumptown health goth portland selfies kinfolk woke. ssss Echo park irony artisan vaporware typewriter. Next level pinterest drinking vinegar lyft mumblecore af small batch heirloom VHS. Fixie banh mi asymmetrical trust fund.

What 3rd party Managed Services?

Neutra trust fund narwhal, palo santo bicycle rights live-edge stumptown health goth portland selfies kinfolk woke. ssss Echo park irony artisan vaporware typewriter. Next level pinterest drinking vinegar lyft mumblecore af small batch heirloom VHS. Fixie banh mi asymmetrical trust fund.

Copied code to clipboard