Installer
Pré-installation
AlternC est prévu pour fonctionner sur la distribution Linux Debian Bookworm.
Pour installer AlternC vous devez :
- avoir un accès SSH à votre serveur.
- Avoir les droits d’administrateur (
sudo -s
ousu
) - vérifier que
#includedir /etc/sudoers.d
est présent dans/etc/sudoers
avec la commandevisudo
.
Installation manuelle
ACL
AlternC dépend des acls noyau afin de gérer les droits utilisateurs notamment en ce qui concerne les dossiers web. Vous devez éventuellement vérifier que votre système n’a pas désactivé les ACLs. Pour ce faire, on peut vérifier dans le fichier /etc/fstab
que noacl (pour ext3/4) ou noattr2 (pour xfs) n’est pas présent. Voici un exemple de mauvaise configuration :
/dev/md1 / ext3 auto,relatime,noacl 0 0
Sur les systèmes récents (après 2012) les ACL sont activées par défaut.
Quota
AlternC peut également gérer les quotas disques des utilisateurs. Contrairement aux ACLs, les quotas ne sont pas nécessaires au fonctionnement d’AlternC. S’ils ne sont pas activé ou installé, AlternC considérera simplement que les quotas d’espace web sont infinis pour chaque utilisateur. Pour ce faire il faut installer le paquet quota :
apt-get install quota
Et encore une fois modifier le /etc/fstab
pour indiquer leur activation :
/dev/md1 / ext3 acl,usrquota,grpquota,errors=remount-ro 0 1
Notez que certains systèmes de virtualisation ou de containérisation n’autorisent pas la modification ou l’utilisation du fichier fstab, ou requièrent de le changer sur le système hôte. Demandez à votre hébergeur dans ce cas.
Remontage de la partition
Une fois ces modifications effectués, il suffit de remonter la partition concerné -en supposant toujours que c’est la partition /
qui contiendra les données utilisateurs avec :
mount -o remount,acl,usrquota,grpquota /
quotacheck -ugm /
quotaon -v /
Vous pouvez être amené à redémarrer votre serveur si vous avez un message de la forme :
quotaon: Your kernel probably supports ext4 quota feature but you are using external quota files. Please switch your filesystem to use ext4 quota feature as external quota files on ext4 are deprecated. ```
# Installation
## MariaDB / MySQL
Il est nécessaire d’installer MariaDB (ou anciennement MySQL) pour pouvoir utiliser AlternC. Si vous voulez l’héberger sur la même machine, vous pouvez le faire avec la commande suivante :
apt-get install mariadb-server
> **IMPORTANT** : Entrez un mot de passe administrateur et SOUVENEZ-VOUS EN car il vous sera demandé en cours d’installation.
Idéalement, stockez ce mot de passe dans un fichier /root/.my.cnf, contenant les lignes suivantes, ce qui vous permettra de vous connecter en tant qu’administrateur sur votre MySQL via une simple commande `mysql` :
[client]
user=root
password=
## Configuration des dépôts
L’ensemble de l’environnement AlternC est disponible sur notre dépôt dédié. Pour commencer il est donc nécessaire d’ajouter la clef du dépôt et les sources des paquets d’AlternC :
sudo wget https://debian.AlternC.org/key.txt -O /usr/share/keyrings/AlternC.asc echo "deb [signed-by=/usr/share/keyrings/AlternC.asc] https://debian.AlternC.org/ $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list.d/AlternC.list
## Installation
Ensuite, mettez à jour la liste des packages disponibles pour apt :
apt-get update
Il ne reste qu’à lancer la commande pour installer AlternC (n’oubliez pas la partie *finaliser l’installation* après cette opération) :
apt-get install AlternC AlternC-ssl AlternC-api
Vous pouvez y ajouter
* `AlternC-mailman` pour gérer des listes de discussion ou de diffusion avec [Mailman](http://www.gnu.org/software/mailman/),
* `AlternC-roundcube` pour pouvoir utiliser un webmail avec [Roundcube](https://roundcube.net/),
* `AlternC-awstats` pour générer des statistiques pour vos sites web avec [Awstats](http://www.awstats.org/),
Ou d’autres greffons à AlternC
## DNS - serveurs de nom
Les serveurs de noms servent à distribuer l’information sur les noms de domaine installés sur votre serveur. Si vous avez besoin de serveurs de noms, AlternC vous propose un service gratuit sur [AlternC.net](https://AlternC.net). Dans ce cas vous pouvez saisir :
* DNS primaire : `ns1.AlternC.net`
* DNS secondaire : `ns2.AlternC.net`
Si vous avez vos propres serveurs DNS, entrez-les ici. (Souvent, le serveur primaire est le nom DNS de votre serveur AlternC)
## Nom de domaine du serveur
Attention, si vous avez un nom de domaine que vous comptez utiliser pour héberger un site, ne l’indiquez pas dans cet écran. En effet, ce nom de domaine sera alors la "porte d’accès" à AlternC.
Utilisez un autre nom de domaine pointant sur votre machine ou un sous-domaine comme `panel.votredomaine.com`.
En résumé, si votre serveur est sur l’IP 12.34.56.78 et que vous avez le nom de domaine exemple.com pour votre site perso, n’utilisez pas exemple.com mais soit l’adresse IP, soit panel.exemple.com, soit le domaine fourni par votre hébergeur ex : serveur234215.groshebergeur.net
* phpMyAdmin
Lors de l’installation, Debian vous demande de configurer PhpMyAdmin, vous pouvez le laisser faire, il vous demandera le mot de passe de l’administrateur de la base de données MySQL pour s’installer. Cependant, AlternC se chargera de modifier quelques peu ces paramètres par la suite.
* Postfix
Choisir "Site Internet", puis suivre les instructions, notamment en rappelant le nom de domaine complet de votre serveur (cf plus haut)
## Finaliser l’installation
Une fois que l’installation est achevée, le script `AlternC.install` **doit être exécuté**. Il va générer notamment les configurations de votre serveur pour qu’AlternC fonctionne.
AlternC.install
Si vous souhaitez installer un certificat SSL pour votre panel (qui sera aussi utilisé par Dovecot, Proftpd, Postfix etc.) nous vous recommandons d’installer LetsEncrypt et de configurer un certificat.
# Post Installation
## Première connexion
Vous pouvez désormais accéder au panel AlternC sur le nom de domaine ou l’IP que vous avez donné. Vous devriez voir une page de login dont l’**accès par défaut que vous devez changer immédiatement** est :
* identifiant : `admin`
* mot de passe : `admin`
N’oubliez pas de modifier votre mot de passe administrateur en vous rendant dans le menu `Gérer les comptes AlternC` !
Auteur Publié le : 23/08/24 Mis à jour : 17/04/25