Create a Linode

Creates a Linode instance on your account. Creating a new Linode incurs a charge on your account. To run this operation, your user needs the add_linodes grant.

• There are several types of Linode you can choose from, that include different sizes, processing potential, and cost. Run the List Linode types operation for more information about each available type.

• Linodes can be created in any one of our available regions. Run the List regions operation to see what's available.

• To fight spam, Akamai restricts outbound connections on ports 25, 465, and 587 on all Linodes for new accounts created after November 5th, 2019. For more information, see our guide on Running a Mail Server.

• To add or modify tags on a Linode, your account user needs unrestricted access. Talk to your local account administrator about access management.

There are several ways to create a Linode, using the objects available in this operation:

Use an Image

This includes using a Linode public image distribution or a private image that you created, based on another Linode.

👍

There are tutorials

We offer example API workflows you can follow for both public image distributions as well as private images.

Use cloud-init

Our cloud-init solution with Metadata automates system configuration and software installation by providing a base-64 encoded cloud-config file.

• You need a compatible image. To check for compatibility, run the List images operation and check for cloud-init under capabilities.

• This also requires a compatible region. Run the List regions operation and look for Metadata under capabilities for a specific region.

Use a StackScript

You can use a StackScript to automate deployment of new systems, through a customized script.

👍

There's a tutorial

We offer an example API workflow you can follow to create a new Linode using a StackScript.

Use a Linode backup

You can create a backup of an existing Linode and restore it to a new one.

👍

There's a tutorial

We offer an example API workflow you can follow to create a new Linode using a backup.

Attached to a private VLAN

• See the interfaces object in the Body Params section for details.

• For more information, see our guide on Getting Started with VLANs.

Create an empty Linode

• Use this operation to create a new one.

• The Linode will remain offline and you need to manually start it. Run the Boot a Linode operation.

• Manually create the Linode's disks and configuration profiles (legacy) or configuration profile interfaces.

📘

You should only use this method for advanced use cases.

Linodes and interfaces

Depending on your account settings, you can choose between legacy configuration interfaces or Linode interfaces when creating a Linode. Only one type of interface is allowed per Linode. The interface_generation field lets you select one interface type for new Linodes when both legacy and Linode interfaces options are available on your account. If a Linode is configured with a Linode interface, legacy configuration interfaces can no longer be used on that Linode.

​​​​​

linode-cli linodes create \
  --label linode123 \
  --root_pass aComplex@Password \
  --booted true \
  --stackscript_id 10079 \
  --stackscript_data '{"gh_username": "linode"}' \
  --region us-east \
  --disk_encryption enabled\
  --placement_group.id 528 \
  --type g6-standard-2 \
  --authorized_keys "ssh-rsa AAAA_valid_public_ssh_key_123456785== user@their-computer" \
  --authorized_users "myUser" \
  --authorized_users "secondaryUser" \
  --metadata.user_data "I2Nsb3VkLWNvbmZpZw==" \
  --firewall_id 9000

<https://techdocs.akamai.com/cloud-computing/docs/getting-started-with-the-linode-cli>

linodes:read_write

<https://techdocs.akamai.com/linode-api/reference/get-started#oauth>