Skip to main content

Install the OS manually from your own image

You can manually install an OS from your own image on a dedicated server. If you have no special requirements for the OS, we recommend using standard images — you can install the OS via autoinstall or manually.

  1. Boot the server in Rescue mode.
  2. Optional: if you are connecting to the server from Windows, install 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 system other than Windows, skip this step.

To connect via SSH from Windows, you need to install OpenSSH Client. For more information on working with OpenSSH, see the Getting started with OpenSSH in Windows guide in the Microsoft documentation.

  1. Run PowerShell as administrator.

  2. Check whether 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 State field in the response from step 2 is NotPresent, the OpenSSH components are not installed. Install OpenSSH Client:

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

    Example response:

    Path          :
    Online        : True
    RestartNeeded : False

  4. If the RestartNeeded field in the response from step 3 is True, restart the computer.

3. Install the OS from your own image

The qemu-iso script is used to install an OS from your own image. The script uploads the iso image to the server, starts the VNC server, and initiates the OS installation process.

You can upload an OS image to the server:

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

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

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

  3. Connect to the server via SSH with port forwarding for VNC – 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: from 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.

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

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

    qemu-iso <url>

    Specify:

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

  6. Wait for the message confirming that the OS image has been uploaded to the server and the VNC server has started:

    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. Follow all stages of the OS installation.

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

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

4. Configure the network interface

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

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

  1. In the Rescue console, find the network interface name by listing information about network interfaces:

    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 the 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 you reboot the server from the OS, the boot template will automatically change to the one that was set before booting the server in Rescue mode.