|
| 1 | +--- |
| 2 | +title: Personal installation templates end of life |
| 3 | +excerpt: Information about removal of your personal installation templates & workaround |
| 4 | +updated: 2025-04-28 |
| 5 | +--- |
| 6 | + |
| 7 | +**This is an important piece of information, please read the entire message carefully.** |
| 8 | + |
| 9 | +## Context |
| 10 | + |
| 11 | +OVHcloud is constantly evolving and must adapt its offerings to the increasingly resilient and regulated cloud market. In order to meet those new challenges the **personal template for dedicated servers OS installation** will be fully decommissioned the **7th of October 2025**. |
| 12 | + |
| 13 | +This service was used to request an OS installation on a dedicated servers by targeting a personal template instead of an operating system with the following elements: |
| 14 | +- operating system to be installed |
| 15 | +- partitioning customization layout, |
| 16 | +- hardware RAID configuration, |
| 17 | +- hostname, |
| 18 | +- SSH public key, |
| 19 | +- post installation script. |
| 20 | + |
| 21 | +This decommissioning will be done in 2 steps: |
| 22 | + |
| 23 | +### Step 1: 17th of June 2025<a name="step-1"></a> |
| 24 | + |
| 25 | +- Customers will no longer be able to **edit** or **add** new personal templates |
| 26 | +- Customers having personal template(s) and active dedicated servers services will receive custom technical informations by email to help them migrate their personal template(s) using the new API call. |
| 27 | + |
| 28 | +### Step 2: 7th of October 2025<a name="step-2"></a> |
| 29 | + |
| 30 | +- Customers will no longer be able to access their personal templates |
| 31 | +- All personal templates data will be deleted |
| 32 | + |
| 33 | +Note that customers will still have the email from the 17th of June 2025 with technical documentation based on their personal templates data to migrate to new API call. |
| 34 | + |
| 35 | +## Instructions |
| 36 | + |
| 37 | +The following section contains specific information per usage of the service. |
| 38 | + |
| 39 | +### Using OVHcloud, SoYouStart or Kimsufi Control Panel<a name="ux"></a> |
| 40 | + |
| 41 | +The `Install one of your templates`{.action} wizard to install an operating system on a dedicated server has already been removed since mid-April. If you were using that wizard you have 3 long-term possibilities: |
| 42 | +- keep using the web graphical interface (not recommended): update your process with screenshots with all the customizations in the OS install wizard (= former `Install from an OVHcloud template`{.action} wizard) |
| 43 | +- move to API (best for automation, but requires programming skills): see section [Using OVHcloud, SoYouStart or Kimsufi API](#api) below. |
| 44 | +- move to the API console (recommended, good tradeoff): update your process with screenshots and links to the console API. Once authenticated, you just need to provide in the documentation the exact JSON payload with the OS installation details. **You will receive the corresponding payloads to your personal templates in the communication of the 17th of June 2025**. |
| 45 | + |
| 46 | +Although you could start exploring by yourself the examples and schemas of the [new API call in the API console](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) and look at its [public documentation](/pages/bare_metal_cloud/dedicated_servers/api-os-installation), here is the temporary workaround you can follow in the meantime of the email of the 17th of June 2025. |
| 47 | + |
| 48 | +#### OVHcloud workaround<a name="ux-ovh"></a> |
| 49 | + |
| 50 | +As mentioned in the [OVHcloud APIs documentation](/pages/manage_and_operate/api/first-steps#sign-in-to-ovhcloud-apis), on the [OVHcloud console API](https://eu.api.ovh.com/console/) page: |
| 51 | +- Click `Authentication`{.action} in the upper left. |
| 52 | +- Select `Login with OVHcloud SSO`{.action}. |
| 53 | +- Enter your OVHcloud credentials. |
| 54 | +- Click `Authorize`{.action} to allow performing API calls through the console. |
| 55 | + |
| 56 | +{.thumbnail} |
| 57 | + |
| 58 | +Then run the API call to trigger an OS reinstallation from your personal template: |
| 59 | +- Select `v1`{.action}. |
| 60 | +- Choose `/dedicated/server`{.action} section. |
| 61 | +- Find `POST /dedicated/server/{serviceName}/install/start`{.action} API call (you can use the filter). |
| 62 | +- In the `serviceName` field, enter the name of the dedicated server you want to install. |
| 63 | +- In the `REQUEST BODY` field (aka. API payload), put the following JSON value (in this example we suppose "my-amazing-template" is the name of the personal template you want to install): |
| 64 | +```json |
| 65 | +{ |
| 66 | + "templateName": "my-amazing-template" |
| 67 | +} |
| 68 | +``` |
| 69 | + |
| 70 | +If you need to list your personal templates and their details, please go to `/me`{.action} section and look at all the `GET` API calls under `/me/installationTemplate`{.action}. |
| 71 | + |
| 72 | +> [!warning] |
| 73 | +> **Performing a [POST /dedicated/server/{serviceName}/install/start](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/install/start) to a dedicated server will erase all the data in that server. PLEASE BE CAREFUL WHILE USING THIS API CALL.** |
| 74 | +> |
| 75 | +
|
| 76 | +Then click `Execute`{.action} button to start the OS installation. |
| 77 | + |
| 78 | +{.thumbnail} |
| 79 | + |
| 80 | +You can go back to the [OVHcloud Control Panel](/links/manager) on the dedicated server dashboard page to track the installation progress. |
| 81 | + |
| 82 | +#### SoYouStart or Kimsufi workarounds<a name="ux-sys-ks"></a> |
| 83 | + |
| 84 | +Open the [SoYouStart console API](https://eu.api.soyoustart.com/console/) or the [Kimsufi console API](https://eu.api.kimsufi.com/console/). |
| 85 | + |
| 86 | +Click `Login`{.action} on the top right corner and enter your credentials. Then click`Log in`{.action} button: you are now authenticated to the console API. |
| 87 | + |
| 88 | +- Open the `/dedicated/server`{.action} section. |
| 89 | +- Find the `POST /dedicated/server/{serviceName}/install/start`{.action} API call. |
| 90 | +- In the `serviceName` field, enter the name of the dedicated server you want to install. |
| 91 | +- In the `templateName` field, enter the name of the personal template you want to install. |
| 92 | + |
| 93 | +If you need to list your personal templates and their details, please go to `/me`{.action} section and look at all the `GET` API calls under `/me/installationTemplate`{.action}. |
| 94 | + |
| 95 | +> [!warning] |
| 96 | +> **Performing a [POST /dedicated/server/{serviceName}/install/start](https://eu.api.soyoustart.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) (or [here](https://eu.api.kimsufi.com/console/#/dedicated/server/%7BserviceName%7D/install/start~POST) for Kimsufi) to a dedicated server will erase all the data in that server. PLEASE BE CAREFUL WHILE USING THIS API CALL.** |
| 97 | +> |
| 98 | +
|
| 99 | +Then click `Execute`{.action} button to start the OS installation. |
| 100 | + |
| 101 | +You can go back to the [SoYouStart](https://eu.soyoustart.com/manager) or [Kimsufi Control Panel](https://www.kimsufi.com/fr/manager) on the dedicated server dashboard page to track the installation progress. |
| 102 | + |
| 103 | +### Using OVHcloud, SoYouStart or Kimsufi API<a name="api"></a> |
| 104 | + |
| 105 | +If you are using the OVHcloud, SoYouStart or Kimsufi API to trigger OS installations from a personal template, you can continue using the `POST /dedicated/server/{serviceName}/install/start`{.action} API call until the 7th of October 2025. |
| 106 | +But please note that starting from the 17th of June 2025, you will no longer be able to add or edit personal templates. |
| 107 | + |
| 108 | +Although you will receive an email with all the details to migrate your API payloads to the [new API call](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall), feel free to start exploring by yourself the examples and schemas of the [new API call in the API console](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) and look at its [public documentation](/pages/bare_metal_cloud/dedicated_servers/api-os-installation). |
| 109 | + |
| 110 | +In your usage, end of personal templates service really simplifies the OS installation on dedicated servers, since the new API call [POST /dedicated/server/{serviceName}/reinstall](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/reinstall) brings all the possible customizations that the old API call [POST /dedicated/server/{serviceName}/install/start](https://eu.api.ovh.com/console/?section=%2Fdedicated%2Fserver&branch=v1#post-/dedicated/server/-serviceName-/install/start) was not able to offer without the need to define a personal template under [/me/installationTemplate](https://eu.api.ovh.com/console/?section=%2Fme&branch=v1#get-/me/installationTemplate) earlier. |
| 111 | + |
| 112 | +The following comparison gives you an idea of the reduced number of API calls to achieve a complex customization configuration involving hardware RAID and custom partitioning: from 4+n calls (where n is the number of partitions you have defined in your partitioning layout) to 1 single API call. |
| 113 | + |
| 114 | +{.thumbnail} |
| 115 | + |
| 116 | +As you can see, everything becomes as-code. |
| 117 | + |
| 118 | +## Go further |
| 119 | + |
| 120 | +[Getting started with a dedicated server](/pages/bare_metal_cloud/dedicated_servers/getting-started-with-dedicated-server) |
| 121 | + |
| 122 | +[Getting started with a Kimsufi, So You Start or Rise dedicated server](/pages/bare_metal_cloud/dedicated_servers/getting-started-with-dedicated-server-eco) |
| 123 | + |
| 124 | +[First steps with the OVHcloud APIs](/pages/manage_and_operate/api/first-steps) |
| 125 | + |
| 126 | +[OVHcloud API & OS installation](/pages/bare_metal_cloud/dedicated_servers/api-os-installation) |
| 127 | + |
| 128 | +[OVHcloud API and Storage](/pages/bare_metal_cloud/dedicated_servers/partitioning_ovh) |
| 129 | + |
| 130 | +Join our [community of users](/links/community). |
0 commit comments