Skip to main content

Metal-published Operating System Images

Equinix Metal™ provides a range of operating systems available for you to deploy on our platform. Metal's operating system images are lightly modified versions of the upstream cloud images tailored to be compatible with our server hardware and network configurations.

We offer Linux and open-source operating systems at no extra cost, licensed operating systems billed by either a usage or bring-your-own license model, or you can bring-your-own operating system with Custom iPXE.

About Our Images​

Changes to our operating system images are tracked in equinixmetal-images/changelog. Images are kept as close to upstream releases as possible.

The changelog aims to show what packages have changed since the last published image, the kernel used in the image, and what deviations from the upstream cloud image (if any) are in the new published image.

When you provision a server using one of our images, you get the most recent image we have published. Once you have provisioned your server, we no longer have access to the system; it is your responsibility to keep the operating system up to date.

If we do not offer an operating system or a version of an operating system that meets your use-case, you can bring your own images using Custom iPXE.

Image Lifecycle​

Equinix Metal publishes the dates of our images' lifecycle in the API.

To find the lifecycle dates for a specific operating system and version, send a GET request to the /operating-systems endpoint, filtering on the operating system slug in the path.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' \
https://api.equinix.com/metal/v1/operating-systems?slug=<os_slug>

Response Parameters:

  • “release_date” - The date the upstream operating system maintainer released this version.
  • "build date" - The date Metal built and released the current operating system image.
  • “deprecation_date” - The date set by the upstream operating system maintainer indicating the end of feature updates and bug fixes, and the beginning of security-only updates for this operating system version.
  • “end_of_service_date” - A Metal-specific date, typically 30 days before end-of-life, when you should for prepare any new provisions to use the newest version of the operating system.
  • “end_of_life_date” - The operating system image no longer receives any updates and can be disabled at any time. Metal typically matches the end-of-life date to the deprecation date set by the operating system maintainer.

The API response also includes a "lifecycle_state" parameter to indicate where the operating system image is in the lifecycle. Possible states are:

  • "testing"
  • "pre_release"
  • "active"
  • "deprecated"
  • "end_of_service"
  • "end_of_life"

Note that images in "testing" and "pre_release" states might not be in a provisionable or operable state. Trying to provision a server with a "testing" or "pre_release" image can result in an error, and should only be used for testing and evaluation.

End-of-Life Images​

When an operating system image is end-of-life, you will no longer be available to provision it on new servers through the console or the API. End-of-life images are eventually de-listed from the Metal API entirely, and their changelogs removed from the changelog repository.

Servers running end-of-life operating systems will continue to run normally, but you will not be able to provision new servers with that same operating system image or version through the Metal console or API.

Operating Systems Reference​

Debian​

Default user: root

Operating SystemSlugDeprecationEnd of ServiceEnd of LifeChangelog
Debian 12debian_122026-06-302028-05-102028-06-10x86_64 arm64
Debian 11debian_112024-08-142026-05-312026-06-31x86_64 arm64

Rocky Linux​

Default user: root

Operating SystemSlugDeprecationEnd of ServiceEnd of LifeChangelog
Rocky Linux 9rocky_92027-05-312032-04-302032-05-31x86_64 arm64
Rocky Linux 8rocky_82024-05-312029-04-292029-05-31x86_64 arm64

Ubuntu​

Default user: root

Operating SystemSlugDeprecationEnd of ServiceEnd of LifeChangelog
Ubuntu 24.04 LTSubuntu_24_042024-09-302029-03-012029-04-01x86_64 arm64
Ubuntu 22.04 LTSubuntu_22_042024-09-302027-03-012027-04-01x86_64 arm64

Server Compatibility​

All of our operating system images go through a validation process in order to be provisionable on our server plans. Not all operating systems are available on every server.

To get a list of which operating systems are available on which servers, use the metal operating-systems get command, and specify the output as JSON.

metal operating-systems get -o json

The response contains a "provisionable_on" object, which is an array of servers that operating system is provisionable on. (The example response is truncated.)

{
    "id": "d782347f-fd9a-4427-b7bb-6b9d4c1ebfc0",
    "slug": "debian_12",
    "name": "Debian 12",
    "version": "12",
    "provisionable_on": [
        "a3.large.x86",
        "c2.medium.x86",
        "c3.large.arm64",
        "c3.medium.x86",
        "c3.small.x86",
        ....    
    ]
},

Provisioning with a Metal-published Image​

When you provision a server through the Equinix Metal console, the available operating systems are filtered by the server you choose.

On Demand Operating System Selection in the Console

Your OS options are similarly filtered if you are provisioning from your Reserved Servers or through the Spot Market.