Déplacer un site créé avec CyberPanel vers /var/www n’est pas seulement une question d’organisation serveur. C’est souvent une étape stratégique pour pouvoir piloter son projet proprement en SSH, automatiser des tâches, utiliser un agent IA comme Claude ou Codex, ou intégrer le site dans un workflow DevOps plus avancé.
Ce guide explique comment migrer correctement un site vers /var/www/guidelondres.fr/public_html sans provoquer d’erreur 403, sans casser OpenLiteSpeed, et sans impacter le SEO.
Sommaire
- Pourquoi déplacer un site CyberPanel vers /var/www ?
- Étape 1 : Copier proprement le projet avec rsync
- Étape 2 : Conserver l’utilisateur système LSAPI
- Étape 3 : Modifier le docRoot dans le vhost OpenLiteSpeed
- Étape 4 : Corriger les permissions Linux pour éviter l’erreur 403
- Structure finale optimisée pour SSH et agents IA
- Pourquoi cette structure est idéale pour un agent IA comme Claude ou Codex
- Bonnes pratiques à retenir
- Conclusion
Pourquoi déplacer un site CyberPanel vers /var/www ?
Par défaut, CyberPanel crée les sites dans :
/home/nomdusite/public_html
Ce fonctionnement est simple, mais moins pratique lorsque :
- On veut gérer plusieurs projets via SSH
- On veut brancher un agent IA sur l’arborescence serveur
- On veut centraliser tous les projets web dans /var/www
- On travaille avec des scripts d’automatisation
- On utilise Git, CI/CD ou des outils DevOps
Déplacer le site vers /var/www permet une structure plus standardisée et plus compatible avec des environnements automatisés.
Étape 1 : Copier proprement le projet avec rsync
On évite un simple mv. On utilise rsync pour conserver les permissions, les liens et la structure.
mkdir -p /var/www/guidelondres.fr/public_html
rsync -aHAX --info=progress2 /home/guidelondres.fr/public_html/ /var/www/guidelondres.fr/public_html/
Pourquoi rsync est important :
- Préserve les droits Linux
- Évite les corruptions
- Permet de relancer la copie en cas d’interruption
- Garde une structure exploitable par un agent IA
Étape 2 : Conserver l’utilisateur système LSAPI
Dans ce cas précis, le site utilise l’utilisateur :
guide8629
Il faut impérativement conserver cet utilisateur dans la configuration OpenLiteSpeed.
On corrige l’ownership :
chown -R guide8629:guide8629 /var/www/guidelondres.fr
Si l’utilisateur ne correspond pas à celui défini dans le scripthandler et l’extprocessor, le serveur renverra une erreur 403.
Étape 3 : Modifier le docRoot dans le vhost OpenLiteSpeed
Ouvrir le fichier :
/usr/local/lsws/conf/vhosts/guidelondres.fr/vhconf.conf
Modifier la ligne :
docRoot /home/guidelondres.fr/public_html
En :
docRoot /var/www/guidelondres.fr/public_html
Puis redémarrer OpenLiteSpeed :
/usr/local/lsws/bin/lswsctrl restart
Étape 4 : Corriger les permissions Linux pour éviter l’erreur 403
Une erreur 403 vient presque toujours d’un problème de permissions sur un dossier parent.
Commandes validées :
chmod 755 /var/www
chmod 755 /var/www/guidelondres.fr
chmod 755 /var/www/guidelondres.fr/public_html
find /var/www/guidelondres.fr/public_html -type d -exec chmod 755 {} \;
find /var/www/guidelondres.fr/public_html -type f -exec chmod 644 {} \;
Explication :
- 755 pour les dossiers permet la traversée
- 644 pour les fichiers permet la lecture sans exécution inutile
- Les dossiers parents doivent aussi être exécutables
Pour diagnostiquer un problème :
namei -l /var/www/guidelondres.fr/public_html/test.php
Cette commande affiche les permissions dossier par dossier.
Structure finale optimisée pour SSH et agents IA
Arborescence propre :
/var/www/guidelondres.fr/public_html
Utilisateur système :
guide8629
Permissions :
- Dossiers : 755
- Fichiers : 644
DocRoot correctement mis à jour dans OpenLiteSpeed.
Pourquoi cette structure est idéale pour un agent IA comme Claude ou Codex
Lorsque tu connectes un agent IA en SSH :
- Il doit pouvoir parcourir l’arborescence sans restriction
- Les permissions doivent être cohérentes
- Le projet doit être organisé de façon standard
- Les chemins doivent être explicites et stables
Une structure claire dans /var/www facilite :
- L’analyse automatique du code
- La génération de scripts
- La modification de fichiers
- L’audit sécurité
- L’optimisation SEO automatisée
- La maintenance continue
Un agent IA fonctionne beaucoup mieux avec une architecture propre qu’avec une structure éclatée dans /home.
Bonnes pratiques à retenir
- Toujours utiliser rsync pour déplacer un projet
- Toujours conserver l’utilisateur LSAPI défini dans le vhost
- Toujours corriger les permissions des dossiers parents
- Toujours redémarrer OpenLiteSpeed après modification du docRoot
- Toujours vérifier les logs en cas d’erreur
Conclusion
Migrer un site CyberPanel vers /var/www permet d’avoir une structure plus professionnelle, compatible avec SSH, DevOps et agents IA comme Claude ou Codex.
L’erreur 403 n’est jamais mystérieuse. Elle provient presque toujours :
- d’un mauvais docRoot
- d’un ownership incorrect
- d’une permission Linux bloquante
Avec cette méthode, tu obtiens :
- Un site stable
- Une structure propre
- Un environnement exploitable par une IA
- Une base solide pour automatiser et scaler tes projets
Permissions — commandes à retenir
# Voir qui possède quoi
ls -la /var/www/guidelondres.fr/public_html/wp-content/themes/wp-theme-guidelondres/
# Rendre les fichiers éditables par ubuntu (à relancer si un nouveau fichier arrive)
sudo chown ubuntu:ubuntu /var/www/guidelondres.fr/public_html/wp-content/themes/wp-theme-guidelondres/*.php
sudo chown ubuntu:ubuntu /var/www/guidelondres.fr/public_html/wp-content/themes/wp-theme-guidelondres/images/
# Vérifier les groupes d'un user
id ubuntu
id guide8629