Deploying an application from the catalogue on a Dedicated Server
Find out how to deploy a ready-to-use application on your bare metal server through automatic post-installation with the application catalogue
Objective
The application catalogue lets you install a ready-to-use application on your OVHcloud dedicated server without any prior system administration knowledge. You choose an application when you (re)install your server, then complete a short configuration form in a secure web interface. The application is installed natively on the server, secured with HTTPS, and made available in minutes.
This guide explains how to use the application catalogue on your OVHcloud dedicated server.
Requirements
- A dedicated server in your OVHcloud account
- Access to the
- Access to the (for the "OVHcloud API" section of this guide)
- Access to the email address of your OVHcloud account, to receive the link to the configuration interface
- A web browser to reach the configuration interface once the installation has completed
OVHcloud Control Panel Access
- Direct link:
- Navigation path:
Bare Metal Cloud>Dedicated servers> Select your server
As with any classical OS installation, a new installation with the application catalogue will erase all the data on the server. Back up any data you want to keep before you start.
Instructions
How the application catalogue works
Deploying an application happens in two steps:
- Selection (at installation): you (re)install your server with an application catalogue image and select one application. This is where you choose which application you want.
- Configuration (after first boot): once the server has restarted, a single-use configurator starts automatically and serves a secure web interface on port
10143. You fill in a short form (for example a site name and an administrator password), then the application is installed automatically and published over HTTPS.
Once the installation succeeds, the configurator removes itself completely from the server: its binary, its service and its working data are deleted. You are left with only your application and full root access to the server.
Applications are installed natively — with system packages and systemd services, on a server dedicated to that single purpose — and not inside a container platform.
Technical limitations:
- Only one application can be deployed through the application catalogue.
- Custom partitioning and hardware RAID configuration are not available for this installation.
This does not mean that you cannot run other applications on the server. It means that only ONE application can be installed through the catalogue. If you want to run additional applications, you will need to install them manually.
Available applications
The catalogue is regularly updated, so when you launch an installation, refer to the list displayed in the OVHcloud Control Panel. The following applications are available:
Selecting your application at installation
Two deployment methods are available, described in the tabs below: install your application from the OVHcloud Control Panel, or use the OVHcloud API to integrate the installation into your own scripts and automate deployments.
Launching the installation
-
Select your server under
Bare Metal Cloud>Dedicated servers. -
In the
General informationtab, next to Operating system (OS), click the...button, then clickReinstall my server.
-
In the Installation from an OVHcloud template window, set Type of OS to
Ready-to-use (graphical user interface), then select the Ubuntu Server 24.04 "Noble Numbat" LTS with Application Installer template. Choose the Target disk group and clickNext.InfoCustom partitioning and hardware RAID configuration are not available with this template, so these options remain disabled.
-
Continue through the installation steps to enter the general settings, such as the server hostname and the SSH key to be added to the server.
-
At the Application to install step, select the single application you want to deploy from the drop-down list, then click
Confirmto launch the installation.
The server reinstalls and then starts the configurator automatically. Once the installation has completed, follow the "Configuring and accessing your application" section below to finish the setup.
Configuring and accessing your application
After the installation, your server boots the single-use configurator automatically. You do not need Linux, SSH or system administration skills for this step — only a web browser.
Step 1: Opening the configurator
Once the installation has completed, you receive an email containing the link to your configurator. It has the following form:
Open that link in your web browser. The token it carries authenticates you, and a secure, session-only cookie is stored, so you can then navigate the configurator without the token in the address bar. Opening the configurator without a valid token returns an Unauthorized page.
Treat this link like a password and do not share it: it grants access to the setup interface of your server.
If your browser shows a certificate warning on the very first load, the configurator is still obtaining its Let's Encrypt certificate and is serving a temporary self-signed one in the meantime. Wait a minute and reload — the switch to the final certificate is automatic.
Step 2: Filling in the configuration form
The configurator opens directly on the application you selected at installation. Depending on that application, you either deploy straight away or fill in a short form first:
- Applications with no fields — Coolify, Dokploy, Easypanel, FastPanel, HestiaCP, Discourse, Matomo and n8n — generate any credentials they need and display them at the end. Click
Deploy. - Applications with fields — WordPress, Drupal, Nextcloud, PrestaShop, OpenClaw and OVHcloud Game Panel — ask for a few values, such as a site name, an administrator password or a database password. Required fields are marked and optional ones may have sensible defaults.
An Installation details panel above the form lists what will be installed and why, along with a link to the vendor's official documentation.
Each field is validated before the deployment starts (for example an email field must contain a valid email address, and passwords have a minimum length). Fix any highlighted field and submit again.
Choose strong passwords: the values you enter here become your real application credentials.
Then click Deploy.
Step 3: Following the deployment
The configurator runs the installation and streams the progress live: a status (pending, then running, then completed or failed), a progress bar, and the installation logs. Values you entered in the form are masked in the logs.
A deployment usually takes a few minutes; heavier applications such as Discourse take longer. You can keep the tab open, but the installation continues on the server even if your browser disconnects — reopen your link to resume watching.
Only one deployment runs at a time. If a deployment is already in progress and you start another, the configurator sends you back to the one in progress instead of starting a second. This is what enforces the "one application per server" rule.
Step 4: Retrieving your access details
When the status reaches completed, the configurator displays a success page with:
- the link to your application, on the standard HTTPS port —
https://<your-server>/; - any credentials or details the application generated for you, such as an administrator username, a database name or a generated password.
A free, auto-renewing Let's Encrypt certificate is issued for your server's hostname during the installation, and the deployed application manages its renewal itself.
Copy your credentials now. The success page is only available during the grace period that follows a successful deployment (5 minutes by default). Once the configurator has removed itself, it can no longer display them — you would have to recover them from within the application itself, or reinstall the server.
Step 5: The configurator removes itself
Shortly after a successful deployment, the configurator deletes its own binary, its service and its working data. From then on:
- the configurator interface on port
10143stops responding — this is expected, not a failure; - your application, its data and its HTTPS certificate are kept;
- your server runs only your application, with no leftover setup tool or administration interface.
You have full ownership of the server, including root access over SSH if you added a key at installation time. The configurator does not manage anything after this point.
If the deployment fails, the configurator does not remove itself: it stays up so that the problem can be diagnosed from the live logs. A failed deployment generally requires reinstalling the server and starting over.
To deploy a different application, reinstall your server from the application catalogue and select the new application.
Troubleshooting
Go further
Install an OS via the OVHcloud API on a Dedicated Server
Understanding the dedicated server boot process
Enabling and configuring the Edge Network Firewall
Join our community of users.