Skip to content

Commit 29613c0

Browse files
benchbzhbenchbzh
authored
Merge pull request #8503 from ovh/FB-install-cloudpanel-vps
FB - Install CloudPanel on VPS
2 parents 4dae57f + 36219fe commit 29613c0

File tree

5 files changed

+376
-0
lines changed

5 files changed

+376
-0
lines changed

‎pages/bare_metal_cloud/virtual_private_servers/install_cloudpanel/guide.en-gb.md‎

Lines changed: 186 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,186 @@
1+
---
2+
title: 'How to install CloudPanel on a VPS or a Dedicated Server'
3+
excerpt: "Find out how to install the CloudPanel administration interface on a VPS or a Dedicated Server"
4+
updated: 2025-12-03
5+
---
6+
7+
## Objective
8+
9+
CloudPanel is a modern, lightweight, and high-performance hosting control panel, offering a web interface to deploy and manage:
10+
11+
- websites using PHP or Node.js;
12+
- databases;
13+
- SSL/TLS certificates (Let’s Encrypt);
14+
- users;
15+
- a firewall.
16+
17+
This guide explains how to install CloudPanel on a VPS or a Dedicated Server and how to connect to it to perform the initial configuration.
18+
19+
> [!warning]
20+
>
21+
> OVHcloud provides services for which you are responsible for the configuration, management, and operation. It is therefore your responsibility to ensure their proper functioning.
22+
>
23+
> We provide this tutorial to assist you with common tasks. However, we recommend that you contact a [specialist service provider](/links/partner) and/or the service publisher if you encounter difficulties. Indeed, we will not be able to provide you with support. More information is available in the "[Go further](#go-further)" section of this tutorial.
24+
25+
## Requirements
26+
27+
- A [VPS](/links/bare-metal/vps) or a [Dedicated Server](/links/bare-metal/bare-metal) with a [recommended configuration](https://www.cloudpanel.io/docs/v2/requirements/) in your [OVHcloud Control Panel](/links/manager).
28+
- An administrative access (sudo) via SSH to your server.
29+
30+
## Instructions
31+
32+
### Step 1 — Connect and update the system
33+
34+
#### Connect to the server
35+
36+
Open a terminal and connect to your VPS (or Dedicated Server) using the following command:
37+
38+
````bash
39+
ssh user@IP_VPS
40+
````
41+
42+
Replace:
43+
44+
- `user` with your username.
45+
- `IP_VPS` with your VPS's IP address.
46+
47+
#### Update the system
48+
49+
Update your operating system. This operation may take several minutes.
50+
51+
> [!tabs]
52+
> Debian and Ubuntu
53+
>>
54+
>> ```bash
55+
>> sudo apt update && sudo apt -y upgrade
56+
>> ```
57+
>>
58+
> AlmaLinux 9 and Rocky Linux 8
59+
>>
60+
>> ```bash
61+
>> sudo dnf -y update
62+
>> ```
63+
64+
### Step 2 — Open required ports (firewall)
65+
66+
To allow incoming and outgoing connections, refer to the **Port Firewall** section of the [official CloudPanel documentation](https://www.cloudpanel.io/docs/v2/guides/best-practices/security/) to find out which ports to open based on your needs.
67+
68+
#### Example of port opening for Debian and Ubuntu
69+
70+
1. Install `UFW`:
71+
72+
```bash
73+
sudo apt -y install ufw
74+
```
75+
76+
2. Open the necessary ports (examples: SSH, CloudPanel panel, HTTP/HTTPS):
77+
78+
```bash
79+
sudo ufw allow 22/tcp
80+
sudo ufw allow 8443/tcp
81+
sudo ufw allow 80/tcp
82+
sudo ufw allow 443/tcp
83+
```
84+
85+
3. Enable `UFW` and check its status (the value "ALLOW" is expected):
86+
87+
```bash
88+
sudo ufw enable
89+
sudo ufw status
90+
```
91+
92+
#### Example of port opening for AlmaLinux 9 and Rocky Linux 8
93+
94+
1. Install `firewalld`:
95+
96+
```bash
97+
sudo dnf -y install firewalld
98+
```
99+
100+
2. Enable and start the service:
101+
102+
```bash
103+
sudo systemctl enable --now firewalld
104+
```
105+
106+
3. Open the necessary ports (examples: SSH, CloudPanel panel, HTTP/HTTPS):
107+
108+
```bash
109+
sudo firewall-cmd --add-service=ssh --permanent
110+
sudo firewall-cmd --add-service=http --permanent
111+
sudo firewall-cmd --add-service=https --permanent
112+
sudo firewall-cmd --add-port=8443/tcp --permanent
113+
```
114+
115+
4. Apply the configuration:
116+
117+
```bash
118+
sudo firewall-cmd --reload
119+
sudo firewall-cmd --list-all
120+
```
121+
122+
### Step 3 — Install CloudPanel
123+
124+
1. Install `wget`:
125+
126+
> [!tabs]
127+
> Debian and Ubuntu
128+
>>
129+
>> ```bash
130+
>> sudo apt -y install wget
131+
>> ```
132+
>>
133+
> AlmaLinux 9 and Rocky Linux 8
134+
>>
135+
>> ```bash
136+
>> sudo dnf -y install wget
137+
>> ```
138+
>>
139+
140+
2. Download the CloudPanel installation script:
141+
142+
```bash
143+
wget https://installer.cloudpanel.io/ce/v2/install.sh -O install.sh
144+
```
145+
146+
3. Run the installer with the desired database engine:
147+
148+
Run the script specifying the database you want to install (MySQL or MariaDB).
149+
150+
- Example with MySQL 8.4:
151+
152+
```bash
153+
sudo DB_ENGINE=MYSQL_8.4 bash install.sh
154+
```
155+
156+
- Example with MariaDB 11.4:
157+
158+
```bash
159+
sudo DB_ENGINE=MARIADB_11.4 bash install.sh
160+
```
161+
162+
The installation may take several minutes, as the script automatically installs the necessary dependencies.
163+
164+
### Step 4 — First connection
165+
166+
Once the installation is complete, enter the URL `https://<IP_VPS>:8443` in your browser, replacing `<IP_VPS>` with your VPS's IP address.
167+
168+
> [!primary]
169+
>
170+
> On the first access, a self-signed certificate is used. Accept the browser warning to continue.
171+
172+
The following interface appears:
173+
174+
![cloudpanel install](images/cloudpanel-setup-interface.png){.thumbnail}
175+
176+
On the first launch, CloudPanel asks you to create the administrator account by providing a username, an email address, and a password. After completing this step, enter the username and password you just set to log in. You then arrive at the CloudPanel administration interface.
177+
178+
## Go further <a name="go-further"></a>
179+
180+
[How to secure a VPS](/pages/bare_metal_cloud/virtual_private_servers/secure_your_vps)
181+
182+
[How to secure a Dedicated Server](/pages/bare_metal_cloud/dedicated_servers/securing-a-dedicated-server)
183+
184+
For specialized services (SEO, development, etc.), contact [OVHcloud partners](/links/partner)
185+
186+
Join our [community of users](/links/community).

‎pages/bare_metal_cloud/virtual_private_servers/install_cloudpanel/guide.fr-fr.md‎

Lines changed: 185 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
1+
---
2+
title: 'Installer CloudPanel sur un VPS ou un serveur dédié'
3+
excerpt: "Découvrez comment installer l'interface d’administration CloudPanel sur un VPS ou un serveur dédié"
4+
updated: 2025-12-03
5+
---
6+
7+
## Objectif
8+
9+
CloudPanel est un panneau de contrôle d’hébergement moderne, léger et performant, offrant une interface web pour déployer et gérer :
10+
11+
- des sites web utilisant PHP ou Node.js ;
12+
- des bases de données ;
13+
- des certificats SSL/TLS (Let’s Encrypt) ;
14+
- des utilisateurs ;
15+
- un pare-feu.
16+
17+
Ce guide explique comment installer CloudPanel sur un VPS ou un serveur dédié et comment vous y connecter pour réaliser la configuration initiale.
18+
19+
> [!warning]
20+
>
21+
> OVHcloud met à votre disposition des services dont la configuration, la gestion et la responsabilité vous incombent. Il vous revient de ce fait d’en assurer le bon fonctionnement.
22+
>
23+
> Nous mettons à votre disposition ce tutoriel afin de vous accompagner au mieux sur des tâches courantes. Néanmoins, nous vous recommandons de faire appel à un [prestataire spécialisé](/links/partner) et/ou de contacter l’éditeur du service si vous éprouvez des difficultés. En effet, nous ne serons pas en mesure de vous fournir une assistance. Plus d’informations dans la section « [Aller plus loin](#go-further) » de ce tutoriel.
24+
25+
## Prérequis
26+
27+
- Disposer d’un [VPS](/links/bare-metal/vps) ou d’un [serveur dédié](/links/bare-metal/bare-metal) avec une [configuration recommandée](https://www.cloudpanel.io/docs/v2/requirements/) dans votre [espace client OVHcloud](/links/manager).
28+
- Disposer d’un accès administrateur (sudo) via SSH à votre serveur.
29+
30+
## En pratique
31+
32+
### Étape 1 — Connexion et mise à jour du système
33+
34+
#### Se connecter au serveur
35+
36+
Ouvrez un terminal et connectez-vous à votre VPS (ou à votre serveur dédié) avec la commande suivante :
37+
38+
```bash
39+
ssh user@IP_VPS
40+
```
41+
42+
Remplacez :
43+
44+
- `user` par votre nom d’utilisateur.
45+
- `IP_VPS` par l’adresse IP de votre VPS.
46+
47+
#### Mettre à jour le système
48+
49+
Mettez votre système d’exploitation à jour. Cette opération peut prendre plusieurs minutes.
50+
51+
> [!tabs]
52+
> Debian et Ubuntu
53+
>>
54+
>> ```bash
55+
>> sudo apt update && sudo apt -y upgrade
56+
>> ```
57+
>>
58+
> AlmaLinux 9 et Rocky Linux 8
59+
>>
60+
>> ```bash
61+
>> sudo dnf -y update
62+
>> ```
63+
64+
### Étape 2 — Ouvrir les ports nécessaires (pare-feu)
65+
66+
Pour autoriser les connexions entrantes et sortantes, référez-vous à la section **Port Firewall** de la [documentation officielle de CloudPanel](https://www.cloudpanel.io/docs/v2/guides/best-practices/security/) pour connaître les ports à ouvrir selon vos besoins.
67+
68+
#### Exemple d’ouverture de ports pour Debian et Ubuntu
69+
70+
1. Installez `UFW` :
71+
72+
```bash
73+
sudo apt -y install ufw
74+
```
75+
76+
2. Ouvrez les ports nécessaires (exemples : SSH, panneau CloudPanel, HTTP/HTTPS) :
77+
78+
```bash
79+
sudo ufw allow 22/tcp
80+
sudo ufw allow 8443/tcp
81+
sudo ufw allow 80/tcp
82+
sudo ufw allow 443/tcp
83+
```
84+
85+
3. Activez `UFW` et vérifiez son statut (la valeur « ALLOW » est attendue) :
86+
87+
```bash
88+
sudo ufw enable
89+
sudo ufw status
90+
```
91+
92+
#### Exemple d’ouverture de ports pour AlmaLinux 9 et Rocky Linux 8
93+
94+
1. Installez `firewalld` :
95+
96+
```bash
97+
sudo dnf -y install firewalld
98+
```
99+
100+
2. Activez et démarrez le service :
101+
102+
```bash
103+
sudo systemctl enable --now firewalld
104+
```
105+
106+
3. Ouvrez les ports nécessaires (exemples : SSH, panneau CloudPanel, HTTP/HTTPS) :
107+
108+
```bash
109+
sudo firewall-cmd --add-service=ssh --permanent
110+
sudo firewall-cmd --add-service=http --permanent
111+
sudo firewall-cmd --add-service=https --permanent
112+
sudo firewall-cmd --add-port=8443/tcp --permanent
113+
```
114+
115+
4. Appliquez la configuration :
116+
117+
```bash
118+
sudo firewall-cmd --reload
119+
sudo firewall-cmd --list-all
120+
```
121+
122+
### Étape 3 — Installer CloudPanel
123+
124+
1. Installez `wget` :
125+
126+
> [!tabs]
127+
> Debian et Ubuntu
128+
>>
129+
>> ```bash
130+
>> sudo apt -y install wget
131+
>> ```
132+
>>
133+
> AlmaLinux 9 et Rocky Linux 8
134+
>>
135+
>> ```bash
136+
>> sudo dnf -y install wget
137+
>> ```
138+
139+
2. Téléchargez le script d’installation de CloudPanel :
140+
141+
```bash
142+
wget https://installer.cloudpanel.io/ce/v2/install.sh -O install.sh
143+
```
144+
145+
3. Lancez l’installateur avec le moteur de base de données souhaité :
146+
147+
Exécutez le script en indiquant la base de données que vous souhaitez installer (MySQL ou MariaDB).
148+
149+
- Exemple avec MySQL 8.4 :
150+
151+
```bash
152+
sudo DB_ENGINE=MYSQL_8.4 bash install.sh
153+
```
154+
155+
- Exemple avec MariaDB 11.4 :
156+
157+
```bash
158+
sudo DB_ENGINE=MARIADB_11.4 bash install.sh
159+
```
160+
161+
L’installation peut durer plusieurs minutes, car le script installe automatiquement les dépendances nécessaires.
162+
163+
### Étape 4 — Première connexion
164+
165+
Une fois l’installation terminée, entrez l’URL `https://<IP_VPS>:8443` dans votre navigateur en remplaçant `<IP_VPS>` par l’adresse IP de votre VPS.
166+
167+
> [!primary]
168+
>
169+
> Lors du premier accès, un certificat autosigné est utilisé. Acceptez l’avertissement du navigateur pour continuer.
170+
171+
L’interface ci-dessous s’affiche :
172+
173+
![cloudpanel install](images/cloudpanel-setup-interface.png){.thumbnail}
174+
175+
Au premier lancement, CloudPanel vous demande de créer le compte administrateur en renseignant un nom d'utilisateur, une adresse e-mail et un mot de passe. Après avoir effectué cette étape, entrez le nom d'utilisateur et le mot de passe que vous venez de définir pour vous connecter. Vous arrivez ensuite sur l’interface d’administration CloudPanel.
176+
177+
## Aller plus loin <a name="go-further"></a>
178+
179+
[Sécuriser un VPS](/pages/bare_metal_cloud/virtual_private_servers/secure_your_vps)
180+
181+
[Sécuriser un serveur dédié](/pages/bare_metal_cloud/dedicated_servers/securing-a-dedicated-server)
182+
183+
Pour des prestations spécialisées (référencement, développement, etc.), contactez les [partenaires OVHcloud](/links/partner)
184+
185+
Échangez avec notre [communauté d’utilisateurs](/links/community).

‎pages/bare_metal_cloud/virtual_private_servers/install_cloudpanel/images/cloudpanel-setup-interface.png‎

56.7 KB
Loading

‎pages/bare_metal_cloud/virtual_private_servers/install_cloudpanel/meta.yaml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
id: 2763c97a-8a32-4a77-8f07-f5c9075d20f7
2+
full_slug: vps-install-cloudpanel
3+
reference_category: bare-metal-cloud-virtual-private-servers-tutorials

‎pages/index.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -230,6 +230,7 @@
230230
+ [How to use SFTP to transfer files](bare_metal_cloud/dedicated_servers/comment-deposer-ou-recuperer-des-donnees-sur-un-serveur-dedie-via-sftp)
231231
+ [How to create a Palworld compatible server](bare_metal_cloud/virtual_private_servers/palworld-server-on-vps)
232232
+ [Installing a web development environment on a VPS or a dedicated server](bare_metal_cloud/virtual_private_servers/install_env_web_dev_on_vps)
233+
+ [How to install CloudPanel on a VPS or a Dedicated Server](bare_metal_cloud/virtual_private_servers/install_cloudpanel)
233234
+ [Installing WordPress with Docker on a VPS or a dedicated server](bare_metal_cloud/virtual_private_servers/install_wordpress_docker_on_vps)
234235
+ [Installing WordPress with WP-CLI on a VPS or a dedicated server](bare_metal_cloud/virtual_private_servers/install_wordpress_site_on_vps)
235236
+ [How to install ISPmanager on a VPS or a dedicated server](bare_metal_cloud/virtual_private_servers/install_ispmanager)
@@ -311,6 +312,7 @@
311312
+ [How to create a Palworld server](bare_metal_cloud/virtual_private_servers/palworld-server-on-vps)
312313
+ [How to set up a web server (LAMP) on Debian or Ubuntu](bare_metal_cloud/dedicated_servers/installing_lamp_debian9_ubuntu18)
313314
+ [How to install a web development environment on a VPS or a dedicated server](bare_metal_cloud/virtual_private_servers/install_env_web_dev_on_vps)
315+
+ [How to install CloudPanel on a VPS or a Dedicated Server](bare_metal_cloud/virtual_private_servers/install_cloudpanel)
314316
+ [How to install WordPress with Docker on a VPS or a dedicated server](bare_metal_cloud/virtual_private_servers/install_wordpress_docker_on_vps)
315317
+ [How to install WordPress with WP-CLI on a VPS or a dedicated server](bare_metal_cloud/virtual_private_servers/install_wordpress_site_on_vps)
316318
+ [Automating the deployment of your website on your VPS via GitHub Actions](bare_metal_cloud/virtual_private_servers/deploy-website-github-actions)

0 commit comments

Comments
 (0)