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 completesprovisioning
. -
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
undercapabilities
when running List images. - Requires a compatible Region. You can determine compatible Regions by checking for
Metadata
undercapabilities
when running List regions.
-
Using a StackScript.
- Run List StackScripts for a list of available StackScripts.
- The Linode will be
running
after it completesprovisioning
. - Requires a compatible Image to be supplied.
- Run Get a StackScript for compatible Images.
- 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.
- Review the
interfaces
property of the Request Body Schema for details. - For more information, see our guide on Getting Started with VLANs.
- Review the
-
Create an empty Linode.
- The Linode will remain
offline
and must be manually started.- Run Boot a Linode.
- Disks and Configs must be created manually.
- This is only recommended for advanced use cases.
- The Linode will remain
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>