Install the OS manually from your own image

Last update: September 01 2026Open in Markdown

You can manually install an OS on a dedicated server from a custom image. If you do not have specific requirements for an OS, we recommend using standard images — from these, you can install an OS via autoinstall or manually.

1. Boot the server in Rescue mode.
2. Optional: if you are connecting to the server from Windows, install the OpenSSH client.
3. Install the OS from your own image.
4. Optional: configure the network interface.
5. Change the boot template.

1. Boot the server in Rescue mode

1. In the control panel, from the top menu, click Products and select Dedicated Servers.

2. In the Servers section, open the server page → Operating System tab.

3. Click Change boot template.

4. In the Boot template field, select Boot to Rescue.

5. Click Save and reboot. The server will be rebooted.

2. Optional: install OpenSSH Client

If you are connecting to the server from a non-Windows OS, skip this step.

To connect via SSH from Windows OS, you need to install OpenSSH Client. Learn more about working with OpenSSH in the Get started with OpenSSH for Windows Microsoft documentation.

1. Run PowerShell as an administrator.

2. Check if OpenSSH Client is installed on your Windows OS:

   Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH.Client'

   The name and status of the OpenSSH components will appear in the response. For example:

   Name  : OpenSSH.Client~~~~0.0.1.0
   State : Installed

   Here State is the status of the components:

   • Installed — the component is installed in the OS; ;
   • NotPresent — the component is not installed in the OS.

3. If the value in the State field in the response to step 2 is NotPresent, the OpenSSH components are not installed. Install OpenSSH Client:

   Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

   Response example:

   Path          :
   Online        : True
   RestartNeeded : False

4. If the response in step 3 shows True in the RestartNeeded field, restart your computer.

3. Install the OS from your own image

The qemu-iso script is used to install an OS from a custom image. The script downloads the ISO image to the server, starts a VNC server, and initiates the OS installation process.

You can load the OS image onto the server:

• via an image URL hosted on a publicly accessible resource. The qemu-iso script will upload the OS image to the server RAM;
• or manually from your local computer to a disk or the server RAM.

Install with image loading via URL

1. Install a VNC client on your local computer. For a list of VNC clients for different OSs, see the Connect via VNC subsection of the Connecting to a server guide.

2. Open CLI. On a local computer running Windows, use PowerShell.

3. Connect to the server via SSH by forwarding the standard VNC port – 5900:

   ssh -L 5900:localhost:5900 root@<ip_address>

   Specify <ip_address> — the server public IP address. You can copy it in the control panel: in the top menu, click Products → Dedicated Servers → Servers → server page → Operating System tab → in the IP field, click.

4. Copy the URL of the OS image you are going to install. The image must be hosted on a publicly accessible resource, and the image size must be at least 2 GB smaller than the server's RAM capacity.

   Чтобы загрузка образа прошла быстрее, мы рекомендуем разместить образ in S3 Selectel — подробнее in инструкции Загрузить объект

5. Run the qemu-iso script. The script will upload installation files to the server, start a VNC server, and initiate the OS installation process:

   qemu-iso <url>

   Specify:

   • <url> — the path to the OS image you copied in step 4;
   • optional: -nic_type <virtual_network_adapter> — тип сетевого устройства для эмуляции in виртуальной машине. Например, для установки VMware ESXi измените виртуальный сетевой адаптер on vmxnet3. Полный список поддерживаемых виртуальных сетевых адаптеров можно посмотреть with помощью команды qemu-system-x86_64 -device help.

6. Wait for the message stating that the OS image has been uploaded to the server and the VNC server is running:

   VM has been created!

7. Open the VNC client on your local computer.

8. Connect to the server. The connection process depends on the VNC client you choose. Connection parameters:

   • IP address — localhost:5900;
   • password — leave the field empty.

9. Complete all OS installation steps.

10. В консоли Rescue нажмите Ctrl + C для завершения процесса qemu-iso.

11. Optional: without exiting the Rescue mode, configure the network interface. We recommend configuring the network interface immediately after OS installation, otherwise the server may be unavailable over the network.

Install with image upload to the server

Upload the image to a disk

1. Make sure your server has an additional disk. The OS image must be placed on a disk where the OS will not be installed. If there is no additional disk on the server, you can change the dedicated server configuration.

2. Install a VNC client on your local computer. For a list of VNC clients for various operating systems, see the Connect via VNC subsection of the Connect to Server guide.

3. Open CLI. On a local computer running Windows, use PowerShell.

4. Connect to the server via SSH by forwarding the standard VNC port — 5900:

   ssh -L 5900:localhost:5900 root@<ip_address>

   Specify <ip_address> — the server public IP address. You can copy it in the control panel: in the top menu, click Products → Dedicated Servers → Servers → server page → Operating System tab → in the IP field, click.

5. Save the image on your local computer.

6. Upload the OS image to the server:

   6.1. View the name of the disk to which you will upload the OS image by displaying disk information:

   lsblk

   6.2. Create a partition on the disk:

     fdisk /dev/<partition>

   Specify <partition> — the disk partition where the OS image will be loaded. For example, for a disk named sdX — sdX1.

   6.3. Создайте файловую систему with помощью утилиты mkfs (используется формат разбиения ext4):

   mkfs.ext4 /dev/<partition>

   Укажите <partition> — раздел on диске, который вы создали on шаге 6.2.

   6.4. Mount the file system:

   mount /dev/<partition> /mnt

   Укажите <partition> — раздел on диске, который вы создали on шаге 6.2.

   6.5. Загрузите образ ОС with локального компьютера on выделенный сервер with помощью утилиты scp:

   scp ./<iso_image_name> root@<ip_address>:/mnt/<partition>/

   Specify:

   • <iso_image_name> — имя файла with образом ОС in формате .iso;
   • <ip_address> — the server public IP address. You can copy it in the control panel: in the top menu, click Products → Dedicated Servers → Servers → server page → Operating System tab → in the IP field, click;
   • <partition> — раздел on диске, который вы создали on шаге 6.2.

7. Запустите скрипт qemu-iso. Скрипт запустит VNC-сервер and инициирует процесс установки ОС:

   qemu-iso <path_to_image>

   Specify:

   • <path_to_image> — путь к файлу with образом ОС, который вы загрузили on сервер on шаге 6.5. Например, /mnt/sdX1/Win_Server_2022.iso;
   • optional: -nic_type <virtual_network_adapter> — тип сетевого устройства для эмуляции in виртуальной машине. Например, для установки VMware ESXi измените виртуальный сетевой адаптер on vmxnet3. Полный список поддерживаемых виртуальных сетевых адаптеров можно посмотреть with помощью команды qemu-system-x86_64 -device help.

8. Wait for the message stating that the VNC server is running:

   VM has been created!

9. Open the VNC client on your local computer.

10. Connect to the server. The connection process depends on the VNC client you choose. Connection parameters:

    • IP address — localhost:5900;
    • password — leave the field empty.

11. В консоли Rescue нажмите Ctrl + C для завершения процесса qemu-iso.

12. Optional: не выходя из режима Rescue, настройте сетевой интерфейс. Мы рекомендуем настроить сетевой интерфейс сразу после установки ОС, иначе сервер может быть недоступен по сети.

Upload the image to RAM

1. Установите VNC-клиент on локальном компьютере. Список VNC-клиентов для разных ОС смотрите Подключиться по VNC инструкции Подключиться к серверу.

2. Open CLI. On a local computer running Windows, use PowerShell.

3. Connect to the server via SSH by forwarding the standard VNC port — 5900:

   ssh -L 5900:localhost:5900 root@<ip_address>

   Specify <ip_address> — the server public IP address. You can copy it in the control panel: in the top menu, click Products → Dedicated Servers → Servers → server page → Operating System tab → in the IP field, click.

4. Save the OS image to your local computer. The image size must be at least 2 GB smaller than the server's RAM capacity.

5. Загрузите образ ОС in оперативную память выделенного сервера with помощью утилиты scp:

   scp ./<iso_image_name> root@<ip_address>:/tmp/

   Specify:

   • <iso_image_name> — имя файла with образом ОС in формате .iso;
   • <ip_address> — the server public IP address. You can copy it in the control panel: in the top menu, click Products → Dedicated Servers → Servers → server page → Operating System tab → in the IP field, click.

6. Запустите скрипт qemu-iso. Скрипт запустит VNC-сервер and инициирует процесс установки ОС:

   qemu-iso <path_to_image>

   Specify:

   • <path_to_image> — the path to the OS image you uploaded to the server in step 5. For example, /tmp/Win_Server_2022.iso;
   • optional: -nic_type <virtual_network_adapter> — тип сетевого устройства для эмуляции in виртуальной машине. Например, для установки VMware ESXi измените виртуальный сетевой адаптер on vmxnet3. Полный список поддерживаемых виртуальных сетевых адаптеров можно посмотреть with помощью команды qemu-system-x86_64 -device help.

7. Wait for the message stating that the VNC server is running:

   VM has been created!

8. Open the VNC client on your local computer.

9. Connect to the server. The connection process depends on the VNC client you choose. Connection parameters:

   • IP address — localhost:5900;
   • password — leave the field empty.

10. Complete all OS installation steps.

11. В консоли Rescue нажмите Ctrl + C для завершения процесса qemu-iso.

12. Optional: не выходя из режима Rescue, настройте сетевой интерфейс. Мы рекомендуем настроить сетевой интерфейс сразу после установки ОС, иначе сервер может быть недоступен по сети.

4. Configure the network interface

После ручной установки ОС in файле конфигурации сети может быть указано имя интерфейса, которое использовалось in виртуальной среде, например eth0. После перезагрузки on физическом сервере сетевой интерфейс может получить другое имя, например enp1s0. Из-за этого несоответствия сервер может быть недоступен по сети, пока имя сетевого интерфейса не будет исправлено on актуальное. Мы рекомендуем исправить имя сразу после установки ОС, не выходя из режима Rescue.

Вы также можете настроить сетевой интерфейс and синхронизировать время with внешним NTP-сервером позднее. Дополнительные настройки ОС зависят от конфигурации образа, который вы устанавливаете.

Ubuntu

Ubuntu 20.04 LTS

1. In the Rescue console, view the network interface name by displaying network interface information:

   ip a

   В ответе найдите интерфейс in состоянии UP, который имеет публичный IP-адрес. Запомните or скопируйте имя сетевого интерфейса in поле altname. Например:

     1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
         link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
         inet 127.0.0.1/8 scope host lo
           valid_lft forever preferred_lft forever
         inet6 ::1/128 scope host noprefixroute
           valid_lft forever preferred_lft forever
     2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
         link/ether 00:0c:00:0f:0:f0 brd ff:ff:ff:ff:ff:ff
         altname enp1s0
         inet 203.0.113.0/24 brd 203.0.113.255 scope global eth0
           valid_lft forever preferred_lft forever
         inet6 fe00::000c:00ff:fe0f:00f0/64 scope link proto kernel_ll
           valid_lft forever preferred_lft forever

   Здесь enp1s0 — имя нужного сетевого интерфейса.

2. Подключитесь к установленной on сервере ОС, для этого запустите скрипт qemu-iso без указания образа:

   qemu-iso

3. Откройте конфигурационный файл утилиты netplan текстовым редактором vi:

   vi /etc/netplan/00-installer-config.yaml

4. Измените значения параметров. Корректные значения можно посмотреть in панели управления: in верхнем меню нажмите Продукты → Выделенные серверы → страница сервера → вкладка Сеть → нажмите on нужную подсеть.

   network:
     ethernets:
       <eth_name>:
         addresses:
           - <ip_address>/<mask>
         gateway4: <gateway>
       renderer: networkd
       version: 2

   Specify:

   • <eth_name> — имя сетевого интерфейса публичной сети, значение из поля altname, которое вы получили on шаге 1;
   • <ip_address> — публичный IP-адрес сервера. Можно скопировать in панели управления: in верхнем меню нажмите Продукты → Выделенные серверы → Серверы → страница сервера → вкладка Операционная система → in поле IP нажмите ;
   • <mask> — маска подсети;
   • <gateway> — шлюз по умолчанию.

5. Press ESC.

6. Выйдите из текстового редактора vi with сохранением изменений:

   :wq

7. Apply the configuration:

   netplan apply

8. Synchronize time with an external NTP server.

Ubuntu 22.04 LTS, 24.04 LTS

1. In the Rescue console, view the network interface name by displaying network interface information:

   ip a

   В ответе найдите интерфейс in состоянии UP, который имеет публичный IP-адрес. Запомните or скопируйте имя сетевого интерфейса in поле altname. Например:

     1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
         link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
         inet 127.0.0.1/8 scope host lo
           valid_lft forever preferred_lft forever
         inet6 ::1/128 scope host noprefixroute
           valid_lft forever preferred_lft forever
     2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
         link/ether 00:0c:00:0f:0:f0 brd ff:ff:ff:ff:ff:ff
         altname enp1s0
         inet 203.0.113.0/24 brd 203.0.113.255 scope global eth0
           valid_lft forever preferred_lft forever
         inet6 fe00::000c:00ff:fe0f:00f0/64 scope link proto kernel_ll
           valid_lft forever preferred_lft forever

   Здесь enp1s0 — имя нужного сетевого интерфейса.

2. Подключитесь к установленной on сервере ОС, для этого запустите скрипт qemu-iso без указания образа:

   qemu-iso

3. Откройте конфигурационный файл утилиты netplan текстовым редактором vi:

   vi /etc/netplan/00-installer-config.yaml

4. Измените значения параметров. Корректные значения можно посмотреть in панели управления: in верхнем меню нажмите Продукты → Выделенные серверы → страница сервера → вкладка Сеть → нажмите on нужную подсеть.

   network:
     version: 2
     renderer: networkd
     ethernets:
       <eth_name>:
         addresses:
           - <ip_address>/<mask>
         gateway4: <gateway>

   Specify:

   • <eth_name> — имя сетевого интерфейса публичной сети, значение из поля altname, которое вы получили on шаге 1;
   • <ip_address> — публичный IP-адрес сервера. Можно скопировать in панели управления: in верхнем меню нажмите Продукты → Выделенные серверы → Серверы → страница сервера → вкладка Операционная система → in поле IP нажмите ;
   • <mask> — маска подсети;
   • <gateway> — шлюз по умолчанию.

5. Press ESC.

6. Выйдите из текстового редактора vi with сохранением изменений:

   :wq

7. Apply the configuration:

   netplan apply

8. Synchronize time with an external NTP server.

Debian

1. In the Rescue console, view the network interface name by displaying network interface information:

   ip a

   В ответе найдите интерфейс in состоянии UP, который имеет публичный IP-адрес. Запомните or скопируйте имя сетевого интерфейса in поле altname. Например:

   1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
       link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
       inet 127.0.0.1/8 scope host lo
         valid_lft forever preferred_lft forever
       inet6 ::1/128 scope host noprefixroute
         valid_lft forever preferred_lft forever
   2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
       link/ether 00:0c:00:0f:00:f0 brd ff:ff:ff:ff:ff:ff
       altname enp1s0
       inet 203.0.113.0/24 brd 203.0.113.255 scope global eth0
         valid_lft forever preferred_lft forever
       inet6 fe00::000c:00ff:fe0f:00f0 /64 scope link proto kernel_ll
         valid_lft forever preferred_lft forever

   Здесь enp1s0 — имя нужного сетевого интерфейса.

2. Подключитесь к установленной on сервере ОС, для этого запустите скрипт qemu-iso без указания образа:

   qemu-iso

3. Откройте конфигурационный файл сетевых интерфейсов текстовым редактором vi:

   vi /etc/network/interfaces.d/50-cloud-init

4. Измените значения параметров. Корректные значения можно посмотреть in панели управления: in верхнем меню нажмите Продукты → Выделенные серверы → Серверы → страница сервера → вкладка Сеть → нажмите on нужную подсеть.

   auto <eth_name>
     iface <eth_name> inet static
       address <ip_address>/<mask>
       gateway <gateway>

   Specify:

   • <eth_name> — имя сетевого интерфейса публичной сети, значение из поля altname, которое вы получили on шаге 1;
   • <ip_address> — публичный IP-адрес сервера, например 203.0.113.0. Можно скопировать in панели управления: in верхнем меню нажмите Продукты → Выделенные серверы → Серверы → страница сервера → вкладка Операционная система → in поле IP нажмите ;
   • <mask> — маска подсети;
   • <gateway> — шлюз.

5. Press ESC.

6. Выйдите из текстового редактора vi with сохранением изменений:

   :wq

7. Restart the network:

   service networking restart

8. Synchronize time with an external NTP server.

Windows

1. Initialize network interfaces; to do this, restore the previous server boot template or reboot the server from the OS. When rebooting the server from the OS, the boot template will automatically change to the one that was set before loading the server in Rescue mode.

2. Загрузите сервер in режиме Rescue

   2.1. В панели управления in верхнем меню нажмите Продукты and выберите Выделенные серверы.

   2.2. В разделе Серверы откройте страницу сервера → вкладка Операционная система.

   2.3. Нажмите Изменить шаблон загрузки.

   2.4. В поле Шаблон загрузки выберите Boot to Rescue.

3. Connect to the server via SSH by forwarding the standard VNC port — 5900.

   ssh -L 5900:localhost:5900 root@<ip_address>

   Specify <ip_address> — the server public IP address. You can copy it in the control panel: in the top menu, click Products → Dedicated Servers → Servers → server page → Operating System tab → in the IP field, click.

4. View the network adapter name by displaying Ethernet network device information:

   lspci | grep Ethernet

   The network adapter name will appear in the response. Remember or copy it.

   01:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03)
   02:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03)

   Здесь Intel Corporation I210 Gigabit Network Connection — имя сетевого адаптера.

5. Подключитесь к установленной on сервере ОС, для этого запустите скрипт qemu-iso без указания образа:

   qemu-iso

6. Open the VNC client on your local computer.

7. Connect to the server. The connection process depends on the VNC client you choose. Connection parameters:

   • IP address — localhost:5900;
   • password — leave the field empty.

8. Open cmd.

9. Open Registry Editor:

   regedit

10. Find the necessary interface:

    10.1. Expand the registry key:

    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4d36e972-e325-11ce-bfc1-08002be10318}

    The list will contain the network interfaces from address 0000 to 0013.

    10.2. Найдите интерфейс, у которого in значении параметра Driver Desc указаны названия сетевых адаптеров, полученных on шаге 4. Сохраните значение параметра NetCfgInstanceId у сетевого адаптера with наименьшим номером in списке.

11. Change the parameter values for the interface:

    11.1. Go to the registry key:

    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\Interfaces\{<net_cfg_instance_id>}

    Укажите <net_cfg_instance_id> — значение параметра NetCfgInstanceId, которое вы сохранили on шаге 10.2.

    11.2. Измените значения параметров. Корректные значения можно посмотреть in панели управления: in верхнем меню нажмите Продукты → Выделенные серверы → страница сервера → вкладка Сеть → нажмите on нужную подсеть.

    • IPAddress — публичный IP-адрес сервера, например 203.0.113.0;
    • SubnetMask — маска подсети;
    • DefaultGateway — шлюз по умолчанию;
    • EnableDHCP — введите 0, если вы не используете DHCP, если используете — 1.

12. Configure remote connection in Server Manager.

13. Synchronize time with an external NTP server.

5. Change the boot template

Restore the previous server boot template or reboot the server from the OS. When rebooting the server from the OS, the boot template will automatically change to the one that was set before loading the server in Rescue mode.