[PUBM-49999] Add boot process guide for dedicated servers

pages/bare_metal_cloud/dedicated_servers/boot-process/guide.en-gb.md

@@ -0,0 +1,136 @@
+---
+title: "Understanding the dedicated server boot process"
+excerpt: "Learn how OVHcloud dedicated servers boot and why PXE must remain first in the boot order"
+updated: 2026-02-06
+---
+
+## Objective
+
+OVHcloud dedicated servers use a network-based boot process (netboot) that provides flexibility and security benefits. This guide explains how the boot process works and why you should not change the default boot order directly in the BIOS/UEFI settings, but instead use the [OVHcloud Control Panel](/links/manager) or the [OVHcloud API](/links/api).
+
+**This guide will help you understand:**
+
+- How the OVHcloud boot process works
+- The available boot modes
+- Why PXE must remain first in the BIOS/UEFI boot order
+- How microcode updates are applied automatically
+
+## Requirements
+
+- A [dedicated server](/links/bare-metal/bare-metal) in your OVHcloud account
+- Access to the [OVHcloud Control Panel](/links/manager) or to the [OVHcloud API](/links/api)
+
+## Instructions
+
+### How the boot process works
+
+OVHcloud dedicated servers use [iPXE](https://ipxe.org/), an advanced network boot firmware, to boot from the network. When you set a boot mode for your server, OVHcloud automatically configures the corresponding iPXE script. When the server powers on, it follows this sequence:
+
+![Boot process overview](images/boot-process.svg){.thumbnail}
+
+1. **PXE boot via DHCP**: The server boots from the network using DHCP on the public interface.
+2. **Download iPXE**: The DHCP server provides the server's public IP address and a filename to download iPXE.
+3. **Query boot service**: iPXE queries an internal OVHcloud boot service to retrieve the script to execute.
+4. **Execute script**: iPXE executes the script based on your configured boot mode.
+
+This process happens every time your server boots.
+
+### Boot modes
+
+You can configure your server to boot in one of the following modes:
+
+| Boot mode | Description | Use case |
+|-----------|-------------|----------|
+| **Boot to disk** | Boots the operating system installed on disk | Normal operation |
+| **Customer rescue** | Boots into a temporary operating system | Troubleshooting, recovery, first-time setup |
+| **Custom boot script** | Executes a user-defined iPXE script | Advanced use cases (volatile OS, custom deployment) |
+
+#### Boot to disk
+
+When set to **boot to disk**, the boot process follows these steps:
+
+**1\. Microcode update**
+
+The system downloads and applies the latest [CPU microcode](https://blog.ovhcloud.com/ovhcloud-microcode-management-at-scale/) for your processor (AMD or Intel). This happens transparently and provides security patches without requiring OS-level or BIOS/UEFI updates.
+
+> [!primary]
+>
+> Microcode updates are verified (signature checked) before being applied. If the microcode download fails, the boot process continues normally — your server will still boot.
+>
+
+**2\. Boot to operating system**
+
+- **Legacy boot servers**: iPXE uses [`sanboot`](https://ipxe.org/cmd/sanboot) to boot directly from the first disk.
+- **UEFI boot servers**: iPXE uses [`sanboot`](https://ipxe.org/cmd/sanboot) to boot the EFI bootloader path (`efiBootloaderPath`) specified during [OS installation](/pages/bare_metal_cloud/dedicated_servers/getting-started-with-dedicated-server#install) (e.g. `\efi\debian\grubx64.efi`).
+
+    When OVHcloud installs an operating system, the boot order is not modified (e.g. GRUB is installed with the `--no-nvram` option) to ensure PXE remains first.
+
+    If `sanboot` fails (e.g. the specified file is broken or cannot be found), iPXE falls back to rEFInd, which auto-detects EFI bootloaders.
+
+    The `efiBootloaderPath` can be changed via the [OVHcloud API](/links/api):
+
+    > [!api]
+    >
+    > @api {v1} /dedicated/server PUT /dedicated/server/{serviceName}
+    >
+
+#### Customer rescue mode
+
+A temporary operating system for troubleshooting, recovery, and initial configuration. Microcode updates are applied before booting into rescue, just as with boot to disk. For more information, see [Activating and using rescue mode](/pages/bare_metal_cloud/dedicated_servers/rescue_mode).
+
+#### Custom boot scripts
+
+For advanced use cases, you can configure a custom iPXE script via the [OVHcloud API](/links/api). For more information, see [Configuring a custom iPXE script](/pages/bare_metal_cloud/dedicated_servers/ipxe-scripts).
+
+> [!warning]
+>
+> Custom boot scripts skip the automatic microcode loading described above.
+>
+
+### Why you must not change the boot order
+
+> [!warning]
+>
+> Do not change the boot order in your server's BIOS/UEFI settings or via tools like `efibootmgr`. PXE (network boot) must remain the first boot option.
+>
+> If you install an operating system manually, ensure your bootloader does not modify the NVRAM boot order (e.g. use `grub-install --no-nvram`).
+>
+
+OVHcloud relies on the network boot process for:
+
+- **Boot mode selection**: The boot service determines whether to boot to rescue, disk, or a custom script.
+- **UEFI boot to disk**: OVHcloud does not create EFI boot entries — iPXE uses `efiBootloaderPath` to chain to the bootloader.
+- **Microcode updates**: Security patches are applied during the boot process.
+
+**If you change the boot order:**
+
+- ❌ Boot mode changes made in the OVHcloud Control Panel or via the OVHcloud API will have no effect.
+- ❌ UEFI servers may fail to boot (no EFI boot entry exists for the on-disk bootloader).
+- ❌ Rescue mode will no longer be accessible.
+- ❌ Microcode updates will no longer be applied automatically.
+- ❌ OVHcloud support may be unable to assist with boot issues.
+
+### Servers with private-only interfaces (OLA)
+
+If your server uses **[OLA (OVHcloud Link Aggregation)](/pages/bare_metal_cloud/dedicated_servers/ola-enable-manager)** — a vRack-only configuration with no public interface — the standard netboot process will not work. Private networks cannot reach the OVHcloud DHCP and boot infrastructure.
+
+In this case, you must deploy your own DHCP, TFTP, and boot services within your private network. For detailed instructions, see the guide on [Managing server reboot with OVHcloud Link Aggregation](/pages/bare_metal_cloud/dedicated_servers/pxe-with-full-private-dedicated).
+
+> [!primary]
+>
+> As of February 2026, OVHcloud is working on native support for netboot over private networks. This guide will be updated when the feature becomes available.
+>
+
+## Go further
+
+[OS installation](/pages/bare_metal_cloud/dedicated_servers/getting-started-with-dedicated-server#install)
+
+[Activating and using rescue mode](/pages/bare_metal_cloud/dedicated_servers/rescue_mode)
+
+[Configuring a custom iPXE script](/pages/bare_metal_cloud/dedicated_servers/ipxe-scripts)
+
+[Managing server reboot with OVHcloud Link Aggregation](/pages/bare_metal_cloud/dedicated_servers/pxe-with-full-private-dedicated)
+
+[OVHcloud microcode management at scale](https://blog.ovhcloud.com/ovhcloud-microcode-management-at-scale/)
+
+Join our [community of users](/links/community).

pages/bare_metal_cloud/dedicated_servers/boot-process/guide.fr-fr.md

@@ -0,0 +1,136 @@
+---
+title: "Comprendre le processus de démarrage des serveurs dédiés"
+excerpt: "Découvrez comment les serveurs dédiés OVHcloud démarrent et pourquoi le PXE doit rester en premier dans l'ordre de boot"
+updated: 2026-02-06
+---
+
+## Objectif
+
+Les serveurs dédiés OVHcloud utilisent un processus de démarrage réseau (netboot) qui offre flexibilité et sécurité. Ce guide explique le fonctionnement du processus de démarrage et pourquoi vous ne devez pas modifier l'ordre de boot directement dans les paramètres BIOS/UEFI, mais plutôt via l'[espace client OVHcloud](/links/manager) ou l'[API OVHcloud](/links/api).
+
+**Ce guide vous aidera à comprendre :**
+
+- Le fonctionnement du processus de démarrage OVHcloud
+- Les modes de démarrage disponibles
+- Pourquoi le PXE doit rester en premier dans l'ordre de boot BIOS/UEFI
+- Comment les mises à jour de microcode sont appliquées automatiquement
+
+## Prérequis
+
+- Un [serveur dédié](/links/bare-metal/bare-metal) dans votre compte OVHcloud
+- Un accès à l'[espace client OVHcloud](/links/manager) ou à l'[API OVHcloud](/links/api)
+
+## En pratique
+
+### Fonctionnement du processus de démarrage
+
+Les serveurs dédiés OVHcloud utilisent [iPXE](https://ipxe.org/), un firmware de démarrage réseau avancé. Lorsque vous définissez un mode de démarrage pour votre serveur, OVHcloud configure automatiquement le script iPXE correspondant. Au démarrage du serveur, la séquence suivante s'exécute :
+
+![Aperçu du processus de démarrage](images/boot-process.svg){.thumbnail}
+
+1. **Démarrage PXE via DHCP** : Le serveur démarre depuis le réseau en utilisant DHCP sur l'interface publique.
+2. **Téléchargement d'iPXE** : Le serveur DHCP fournit l'adresse IP publique du serveur et un nom de fichier pour télécharger iPXE.
+3. **Requête au service de boot** : iPXE interroge un service de boot interne OVHcloud pour récupérer le script à exécuter.
+4. **Exécution du script** : iPXE exécute le script en fonction du mode de démarrage configuré.
+
+Ce processus se produit à chaque démarrage de votre serveur.
+
+### Modes de démarrage
+
+Vous pouvez configurer votre serveur pour démarrer dans l'un des modes suivants :
+
+| Mode de démarrage | Description | Cas d'usage |
+|-------------------|-------------|-------------|
+| **Démarrage sur disque** | Démarre le système d'exploitation installé sur le disque | Fonctionnement normal |
+| **Mode rescue** | Démarre sur un système d'exploitation temporaire | Dépannage, récupération, configuration initiale |
+| **Script de boot personnalisé** | Exécute un script iPXE défini par l'utilisateur | Cas avancés (OS volatile, déploiement personnalisé) |
+
+#### Démarrage sur disque
+
+En mode **démarrage sur disque**, le processus de boot suit ces étapes :
+
+**1\. Mise à jour du microcode**
+
+Le système télécharge et applique le dernier [microcode CPU](https://blog.ovhcloud.com/ovhcloud-microcode-management-at-scale/) pour votre processeur (AMD ou Intel). Cela se fait de manière transparente et fournit des correctifs de sécurité sans nécessiter de mises à jour au niveau de l'OS ou du BIOS/UEFI.
+
+> [!primary]
+>
+> Les mises à jour de microcode sont vérifiées (signature contrôlée) avant d'être appliquées. Si le téléchargement du microcode échoue, le processus de démarrage continue normalement — votre serveur démarrera quand même.
+>
+
+**2\. Démarrage du système d'exploitation**
+
+- **Serveurs en boot Legacy** : iPXE utilise [`sanboot`](https://ipxe.org/cmd/sanboot) pour démarrer directement depuis le premier disque.
+- **Serveurs en boot UEFI** : iPXE utilise [`sanboot`](https://ipxe.org/cmd/sanboot) pour démarrer le bootloader EFI (`efiBootloaderPath`) spécifié lors de l'[installation de l'OS](/pages/bare_metal_cloud/dedicated_servers/getting-started-with-dedicated-server#install) (par exemple, `\efi\debian\grubx64.efi`).
+
+    Lorsqu'OVHcloud installe un système d'exploitation, l'ordre de boot n'est pas modifié (par exemple, GRUB est installé avec l'option `--no-nvram`) afin que le PXE reste en premier.
+
+    Si `sanboot` échoue (par exemple, le fichier spécifié est corrompu ou introuvable), iPXE bascule sur rEFInd, qui détecte automatiquement les bootloaders EFI.
+
+    Le paramètre `efiBootloaderPath` peut être modifié via l'[API OVHcloud](/links/api) :
+
+    > [!api]
+    >
+    > @api {v1} /dedicated/server PUT /dedicated/server/{serviceName}
+    >
+
+#### Mode rescue
+
+Un système d'exploitation temporaire pour le dépannage, la récupération et la configuration initiale. Les mises à jour de microcode sont appliquées avant le démarrage en rescue, comme pour le démarrage sur disque. Pour plus d'informations, consultez notre guide « [Activer et utiliser le mode rescue](/pages/bare_metal_cloud/dedicated_servers/rescue_mode) ».
+
+#### Scripts de boot personnalisés
+
+Pour les cas d'usage avancés, vous pouvez configurer un script iPXE personnalisé via l'[API OVHcloud](/links/api). Pour plus d'informations, consultez notre guide « [Configurer un script iPXE personnalisé](/pages/bare_metal_cloud/dedicated_servers/ipxe-scripts) ».
+
+> [!warning]
+>
+> Les scripts de boot personnalisés ne bénéficient pas du chargement automatique du microcode décrit ci-dessus.
+>
+
+### Pourquoi ne pas modifier l'ordre de boot
+
+> [!warning]
+>
+> Ne modifiez pas l'ordre de boot dans les paramètres BIOS/UEFI de votre serveur ou via des outils comme `efibootmgr`. Le PXE (démarrage réseau) doit rester la première option de boot.
+>
+> Si vous installez un système d'exploitation manuellement, assurez-vous que votre bootloader ne modifie pas l'ordre de boot NVRAM (par exemple, utilisez `grub-install --no-nvram`).
+>
+
+OVHcloud s'appuie sur le processus de démarrage réseau pour :
+
+- **Sélectionner le mode de boot** : Le service de boot détermine s'il faut démarrer en rescue, sur disque ou avec un script personnalisé.
+- **Démarrage sur disque UEFI** : OVHcloud ne crée pas d'entrées de boot EFI — iPXE utilise `efiBootloaderPath` pour chaîner vers le bootloader.
+- **Appliquer les mises à jour de microcode** : Les correctifs de sécurité sont appliqués pendant le processus de démarrage.
+
+**Si vous modifiez l'ordre de boot :**
+
+- ❌ Les changements de mode de boot effectués dans l'espace client OVHcloud ou via l'API OVHcloud n'auront aucun effet.
+- ❌ Les serveurs UEFI pourraient ne pas démarrer (aucune entrée de boot EFI n'existe pour le bootloader sur disque).
+- ❌ Le mode rescue ne sera plus accessible.
+- ❌ Les mises à jour de microcode ne seront plus appliquées automatiquement.
+- ❌ Le support OVHcloud pourrait ne pas être en mesure de vous aider en cas de problème de démarrage.
+
+### Serveurs avec interfaces privées uniquement (OLA)
+
+Si votre serveur utilise **[OLA (OVHcloud Link Aggregation)](/pages/bare_metal_cloud/dedicated_servers/ola-enable-manager)** — une configuration *vRack-only* sans interface publique — le processus netboot standard ne fonctionnera pas. Les réseaux privés ne peuvent pas atteindre l'infrastructure DHCP et de boot OVHcloud.
+
+Dans ce cas, vous devez déployer vos propres services DHCP, TFTP et de boot au sein de votre réseau privé. Pour des instructions détaillées, consultez le guide « [Gérer le redémarrage de votre serveur avec OVHcloud Link Aggregation](/pages/bare_metal_cloud/dedicated_servers/pxe-with-full-private-dedicated) ».
+
+> [!primary]
+>
+> En février 2026, OVHcloud travaille sur le support natif du netboot sur les réseaux privés. Ce guide sera mis à jour lorsque la fonctionnalité sera disponible.
+>
+
+## Aller plus loin
+
+[Installation de l'OS](/pages/bare_metal_cloud/dedicated_servers/getting-started-with-dedicated-server#install)
+
+[Activer et utiliser le mode rescue](/pages/bare_metal_cloud/dedicated_servers/rescue_mode)
+
+[Configurer un script iPXE personnalisé](/pages/bare_metal_cloud/dedicated_servers/ipxe-scripts)
+
+[Gérer le redémarrage de votre serveur avec OVHcloud Link Aggregation](/pages/bare_metal_cloud/dedicated_servers/pxe-with-full-private-dedicated)
+
+[OVHcloud microcode management at scale](https://blog.ovhcloud.com/ovhcloud-microcode-management-at-scale/)
+
+Échangez avec notre [communauté d'utilisateurs](/links/community).

pages/bare_metal_cloud/dedicated_servers/boot-process/images/boot-process.mmd

@@ -0,0 +1,33 @@
+flowchart TD
+    subgraph NETBOOT["Network Boot (every boot)"]
+        A["1. PXE boot via DHCP<br/>on public interface"]
+        A --> B["2. Download iPXE"]
+        B --> C["3. Query boot service"]
+    end
+
+    C --> D{"4. Execute script"}
+
+    subgraph RESCUE["Customer Rescue"]
+        G1[Download, verify and apply<br/>CPU microcode]
+        G1 --> G2[Boot live<br/>rescue system]
+    end
+
+    subgraph DISK["Boot to Disk"]
+        H[Download, verify and apply<br/>CPU microcode]
+        H --> I{Firmware?}
+        I -->|UEFI boot| J[sanboot to<br/>efiBootloaderPath]
+        I -->|Legacy boot| K[sanboot to<br/>first disk]
+        J --> L{Success?}
+        L -->|Yes| M[OS loads]
+        L -->|No| N[rEFInd fallback<br/>auto-detects EFI bootloaders]
+        K --> M
+        N --> M
+    end
+
+    subgraph CUSTOM["Custom boot script"]
+        O[Execute user-defined<br/>iPXE script<br/>no microcode loading]
+    end
+
+    D -->|Customer rescue| G1
+    D -->|Boot to disk| H
+    D -->|Custom script| O

pages/bare_metal_cloud/dedicated_servers/boot-process/meta.yaml

@@ -0,0 +1,2 @@
+id: 00d8ab6e-71ee-4a64-aaf3-7c2cbd52acaf
+full_slug: dedicated-servers-boot-process

pages/bare_metal_cloud/dedicated_servers/bring-your-own-image/guide.de-de.md

@@ -1,7 +1,7 @@
 ---
 title: Bring Your Own Image (BYOI) (EN)
 excerpt: Find out how to easily deploy your own images on dedicated servers
-updated: 2025-04-29
+updated: 2026-02-06
 ---
 
 ## Objective
@@ -153,7 +153,7 @@ Once you completed the fields, start the deployment by clicking `Execute`{.actio
 
 ¹ Can either be a `#cloud-config` or a script. It must be in one-line, and have `\n` for line-return<br />
 ² Use only if you need HTTP Headers, such as `Basic Auth`<br />
-³ Examples of Efi bootloader path:
+³ The EFI bootloader path is used by iPXE to boot your operating system. For more information, see [Understanding the dedicated server boot process](/pages/bare_metal_cloud/dedicated_servers/boot-process). Examples:
 
 | Operating System | efiBootloaderPath |
 |-|-|
@@ -192,4 +192,6 @@ The following table gives an overview of well known customer errors and how to f
 
 [Bring Your Own Image (BYOI) / Bring Your Own Linux (BYOLinux), a comparison sheet](/pages/bare_metal_cloud/dedicated_servers/bring-your-own-image-versus-bring-your-own-linux)
 
+[Understanding the dedicated server boot process](/pages/bare_metal_cloud/dedicated_servers/boot-process)
+
 Join our user community on <https://community.ovh.com/en/>.

pages/bare_metal_cloud/dedicated_servers/bring-your-own-image/guide.en-asia.md

@@ -1,7 +1,7 @@
 ---
 title: Bring Your Own Image (BYOI)
 excerpt: Find out how to easily deploy your own images on dedicated servers
-updated: 2025-04-29
+updated: 2026-02-06
 ---
 
 ## Objective
@@ -153,7 +153,7 @@ Once you completed the fields, start the deployment by clicking `Execute`{.actio
 
 ¹ Can either be a `#cloud-config` or a script. It must be in one-line, and have `\n` for line-return<br />
 ² Use only if you need HTTP Headers, such as `Basic Auth`<br />
-³ Examples of Efi bootloader path:
+³ The EFI bootloader path is used by iPXE to boot your operating system. For more information, see [Understanding the dedicated server boot process](/pages/bare_metal_cloud/dedicated_servers/boot-process). Examples:
 
 | Operating System | efiBootloaderPath |
 |-|-|
@@ -192,4 +192,6 @@ The following table gives an overview of well known customer errors and how to f
 
 [Bring Your Own Image (BYOI) / Bring Your Own Linux (BYOLinux), a comparison sheet](/pages/bare_metal_cloud/dedicated_servers/bring-your-own-image-versus-bring-your-own-linux)
 
+[Understanding the dedicated server boot process](/pages/bare_metal_cloud/dedicated_servers/boot-process)
+
 Join our user community on <https://community.ovh.com/en/>.

pages/bare_metal_cloud/dedicated_servers/bring-your-own-image/guide.en-au.md

@@ -1,7 +1,7 @@
 ---
 title: Bring Your Own Image (BYOI)
 excerpt: Find out how to easily deploy your own images on dedicated servers
-updated: 2025-04-29
+updated: 2026-02-06
 ---
 
 ## Objective
@@ -153,7 +153,7 @@ Once you completed the fields, start the deployment by clicking `Execute`{.actio
 
 ¹ Can either be a `#cloud-config` or a script. It must be in one-line, and have `\n` for line-return<br />
 ² Use only if you need HTTP Headers, such as `Basic Auth`<br />
-³ Examples of Efi bootloader path:
+³ The EFI bootloader path is used by iPXE to boot your operating system. For more information, see [Understanding the dedicated server boot process](/pages/bare_metal_cloud/dedicated_servers/boot-process). Examples:
 
 | Operating System | efiBootloaderPath |
 |-|-|
@@ -192,4 +192,6 @@ The following table gives an overview of well known customer errors and how to f
 
 [Bring Your Own Image (BYOI) / Bring Your Own Linux (BYOLinux), a comparison sheet](/pages/bare_metal_cloud/dedicated_servers/bring-your-own-image-versus-bring-your-own-linux)
 
+[Understanding the dedicated server boot process](/pages/bare_metal_cloud/dedicated_servers/boot-process)
+
 Join our user community on <https://community.ovh.com/en/>.