API
Training

Create a Linode

post https://api.linode.com//linode/instances

Creates a Linode Instance on your Account. In order for this request to complete successfully, your User must have the add_linodes grant. Creating a new Linode will incur a charge on your Account.

Linodes can be created using one of the available Types. Run List Linode types to get more information about each Type's specs and cost.

Linodes can be created in any one of our available Regions, which are accessible from the List regions operation.

In an effort to fight spam, Linode 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.

Important. You must be an unrestricted User in order to add or modify tags on Linodes.

Linodes can be created in a number of ways:

  • Using a Linode Public Image distribution or a Private Image you created based on another Linode.

    • Run the List images operation with authentication to view all available Images.

    • The Linode will be running after it completes provisioning.

    • A default config with two Disks, one being a 512 swap disk, is created.

      • swap_size can be used to customize the swap disk size.

    • Requires a root_pass be supplied to use for the root User's Account.

    • It is recommended to supply SSH keys for the root User using the authorized_keys field.

    • You may also supply a list of usernames via the authorized_users field.

      • These users must have an SSH Key associated with your Profile first. See the Add an SSH key) operation for more information.

  • Using cloud-init with Metadata.

    • Automate system configuration and software installation by providing a base-64 encoded cloud-config file.
    • Requires a compatible Image. You can determine compatible Images by checking for cloud-init under capabilities when running List images.
    • Requires a compatible Region. You can determine compatible Regions by checking for Metadata under capabilities when running List regions.

  • Using a StackScript.

    • Run List StackScripts for a list of available StackScripts.
    • The Linode will be running after it completes provisioning.
    • Requires a compatible Image to be supplied.
    • Requires a root_pass be supplied to use for the root User's Account.
    • It is recommended to supply SSH keys for the root User using the authorized_keys field.
    • You may also supply a list of usernames via the authorized_users field.
      • These users must have an SSH Key associated with your Profile first. See Add an SSH key for more information.

  • Using one of your other Linode's backups.

    • You must create a Linode large enough to accommodate the Backup's size.
    • The Disks and Config will match that of the Linode that was backed up.
    • The root_pass will match that of the Linode that was backed up.

  • Attached to a private VLAN.

  • Create an empty Linode.

    • The Linode will remain offline and must be manually started.
    • Disks and Configs must be created manually.
    • This is only recommended for advanced use cases.

​

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://www.linode.com/docs/products/tools/cli/get-started/>

linodes:read_write

<https://techdocs.akamai.com/linode-api/reference/get-started#oauth>
Language
Authorization
Click Try It! to start a request and see the response here!