Leasing a server
-
In the management console
, select the folder you want to lease a server in. -
In the list of services, select BareMetal and click Lease server.
-
In the Availability zone field, select the availability zone the server will be leased in.
-
In the Pool field, select the pool the server will be leased from.
-
Under Configuration, select the appropriate server configuration.
-
(Optional) Under Disk, configure disk partitioning:
-
Click Configure disk layout.
-
Specify the partitioning parameters. To create a new partition, click
Add partition.To build RAID arrays and configure disk partitions yourself, click Remove RAID.
-
Click Save.
-
-
Under Image, select:
-
Marketplace
: To install one of the available Yandex Cloud Marketplace public OS images on the server. -
No OS
: To lease a server without an operating system.You can install the OS from a custom ISO image later.
-
-
Under Lease conditions:
- In the Number of servers field, specify the number of servers you want to lease.
-
In the Lease duration field, select a lease period:
1 day
,1 month
,3 months
,6 months
, or1 year
.When this period expires, server lease will automatically be renewed for the same period. You cannot terminate the lease during the specified lease period, but you can refuse to extend the server lease further.
-
Under Private network, in the Private subnet field, select an existing private subnet or click Create to create a new one.
-
Under Public network, in the Public address field, select a public IP address assignment method:
From ephemeral subnet
: Assign a random IP address. If you need to get the IP address when creating a server via a request to a DHCP server, enable Assign via DHCP.
-
From a dedicated subnet
: To assign an IP address from the range of addresses of a dedicated public subnet.In the field that opens, select a public subnet or click Order to order a new one.
Warning
The dedicated public subnet does not have a DHCP server; therefore, on the network interface of the server connected to such subnet, you should manually configure a static IP address from the subnet’s range of available public IP addresses and specify the default gateway address.
No address
: Do not assign a public IP address.
-
If you are installing an OS from a Marketplace public image, specify server access settings under Access:
-
In the Password field, select one of the following options to create a root password:
-
To generate a new root password, select
New password
and click Generate.Warning
This option requires you to maintain password security. Save the password you generated in a secure location. Yandex Cloud does not store it, and you will not be able to retrieve it once the server is deployed.
-
To use the root password saved in a Yandex Lockbox secret, select
Lockbox secret
.In the Name, Version, and Key fields, select the secret containing your password, its version, and its key, respectively.
If you do not have a Yandex Lockbox secret, click Create to create it.
Choose the
Custom
secret type to specify a custom password orGenerated
to generate password automatically.
-
-
In the Public SSH key field, select the SSH key saved in your organization user profile.
If there are no SSH keys in your profile or you want to add a new key:
-
Click Add key.
-
Enter a name for the SSH key.
-
Select one of the following:
-
Enter manually
: Paste the contents of the public SSH key. You need to create an SSH key pair on your own. -
Load from file
: Upload the public part of the SSH key. You need to create an SSH key pair on your own. -
Generate key
: Automatically create an SSH key pair.When adding a new SSH key, an archive containing the key pair will be created and downloaded. In Linux or macOS-based operating systems, unpack the archive to the
/home/<user_name>/.ssh
directory. In Windows, unpack the archive to theC:\Users\<user_name>/.ssh
directory. You do not need additionally enter the public key in the management console.
-
-
Click Add.
The system will add the SSH key to your organization user profile. If the organization has disabled the ability for users to add SSH keys to their profiles, the added public SSH key will only be saved in the user profile inside the newly created resource.
-
-
-
Optionally, enable server backup in Yandex Cloud Backup:
- Enable Backup.
- Select an existing backup policy or create a new one.
- Select a service account with the
baremetal.editor
andbackup.editor
roles assigned or create a new one.
For more information, see Leasing a Yandex BareMetal server connected to Cloud Backup.
-
Under Server information:
- Specify the server name in the Name field.
- Optionally, add a server description in the Description field.
- Optionally, set labels in the Labels field.
-
Click Lease server.
If you do not have the Yandex Cloud CLI installed yet, install and initialize it.
By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID>
command. You can also set a different folder for any specific command using the --folder-name
or --folder-id
parameter.
-
View the description of the command for leasing a server:
yc baremetal server create --help
-
Get a list of configurations:
yc baremetal configuration list
-
Lease a server:
yc baremetal server create \ --hardware-pool-id <pool> \ --configuration-id <configuration_ID> \ --storage "partition={type=<file_system>,size-gib=<partition_size>,mount-point=<mount_point>},raid-type=<RAID array level>,disk={id=<disk_number>,size-gib=<disk_size>,type=<disk_type>}" \ --os-settings "image-id=<image_ID>,image-name=<image_name>,ssh-key-public=<public_SSH_key_contents>,ssh-key-user-id=<SSH_key_user_ID>,password-plain-text=<user_password>,password-lockbox-secret={secret-id=<secret_ID>,version-id=<secret_version>,key=<secret_key>}" \ --rental-period-id <lease_period> \ --network-interfaces private-subnet-id=<private_subnet_ID> \ --network-interfaces public-subnet-id=<public_subnet_ID> \ --name <server_name> \ --description "<server_description>" \ --labels <label_key>=<label_value>
Where:
-
--hardware-pool-id
: Pool to lease a server from. -
--configuration-id
: Server configuration ID. -
--storage
: Disk partitioning settings. This is an optional parameter. Possible settings:-
partition
: Disk partition:type
: File system. The possible values areExt3
,Ext4
,Swap
, orXfs
.size-gib
: Partition size in GB.mount-point
: Mount point.
-
disk
: Disk:id
: Disk number.size-gib
: Disk size in GB.type
: Disk type.
-
raid-type
: RAID array level.
-
-
--os-settings
: OS settings. To lease a server without an operating system, skip this parameter. Possible settings:-
image-id
: ID of an available Yandex Cloud Marketplace public OS image. -
image-name
: Name of one of the available Yandex Cloud Marketplace public OS images. -
ssh-key-public
: Public SSH key contents. You will need to create your own SSH key pair to establish a secure server connection. -
ssh-key-user-id
: SSH key user ID. -
password-plain-text
: Root user's password.Warning
This option requires you to maintain password security. Save the password you generated in a secure location. Yandex Cloud does not store it, and you will not be able to retrieve it once the server is deployed.
-
password-lockbox-secret
: Yandex Lockbox secret:secret-id
: Secret ID.version-id
: Secret version.key
: Secret key.
You can install the OS from a custom ISO image later.
-
-
--rental-period-id
: Server lease period. The possible values are1 day
,1 month
,3 months
,6 months
or1 year
.When this period expires, server lease will automatically be renewed for the same period. You cannot terminate the lease during the specified lease period, but you can refuse to extend the server lease further.
-
--network-interfaces
: Network settings:private-subnet-id
: Private subnet ID.public-subnet-id
: Dedicated public subnet ID. This is an optional parameter.
Warning
The dedicated public subnet does not have a DHCP server; therefore, on the network interface of the server connected to such subnet, you should manually configure a static IP address from the subnet’s range of available public IP addresses and specify the default gateway address.
--name
: Server name.--description
: Server description. This is an optional parameter.--labels
: Server labels. This is an optional parameter.
-
Once you lease a server, you can install or reinstall the OS at any time using either a Cloud Marketplace public image or your own custom ISO. For more information, see Reinstalling an OS from a Marketplace image and Reinstalling an OS from a custom ISO image.
Example
Lease a server with a public OS image:
yc baremetal server create \
--hardware-pool-id ru-central1-m4 \
--configuration-id ly5lymxdltk3xitpkrmi \
--storage "partition={type=EXT3,size-gib=1000,mount-point=/},partition={type=EXT4,size-gib=500,mount-point=/root},raid-type=RAID0,disk={id=1,size-gib=1862,type=HDD},disk={id=2,size-gib=1862,type=HDD}" \
--storage "partition={type=EXT3,size-gib=1000,mount-point=/boot},partition={type=SWAP,size-gib=10},disk={id=3,size-gib=1862,type=HDD}" \
--os-settings "image-id=ly5vhn4lapeva2qs3bx5,ssh-key-public=ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGcM4tRfRHJGrlLMT+YJFr+aOdSQYnYYjAoj********,password-lockbox-secret={secret-id=e6qmvglkitn6********,version-id=e6qquvv4kh8e********,key=password}" \
--rental-period-id 1-day \
--network-interfaces private-subnet-id=ly5ztavbezrf******** \
--network-interfaces public-subnet-id=ly5o6l7pxmk2********* \
--name demo-baremetal-server \
--description "My first BareMetal server" \
--labels env=test
Result:
done (22m45s)
id: ly52dtzdi55r********
cloud_id: b1gia87mbaom********
folder_id: b1g0ijbfaqsn********
name: demo-baremetal-server
description: My first BareMetal server
zone_id: ru-central1-m
hardware_pool_id: ru-central1-m4
status: PROVISIONING
os_settings:
image_id: ly5vhn4lapev********
ssh_public_key: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGcM4tRfRHJGrlLMT+YJFr+aOdSQYnYYjAoj********
storages:
- partitions:
- type: EXT3
size_gib: "999"
mount_point: /
- type: EXT4
size_gib: "499"
mount_point: /root
raid:
type: RAID0
disks:
- id: ly5ual3jbnhr********
type: HDD
size_gib: "1862"
- id: ly54qfjw55d4********
type: HDD
size_gib: "1862"
- partitions:
- type: EXT3
size_gib: "999"
mount_point: /boot
- type: SWAP
size_gib: "9"
disk:
id: ly5ojffpngul********
type: HDD
size_gib: "1862"
network_interfaces:
- id: ly5wbsiklrtd********
mac_address: 00:25:90:92:fa:48
private_subnet:
private_subnet_id: ly5ztavbezrf********
- id: ly5ygl4loyy6********
mac_address: 00:25:90:92:fa:49
public_subnet:
public_subnet_id: ly5o6l7pxmk2********
configuration_id: ly5lymxdltk3xitpkrmi
created_at: "2025-07-06T21:53:46.186130Z"
labels:
env: test