Installation de Carto-SI avec Docker

Ce guide vous accompagne pas à pas dans l'installation de Carto-SI via Docker.

🎯 Vue d'ensemble

Temps d'installation estimé : 5 minutes

✅ Prérequis

Avant de commencer, vérifiez que votre système répond aux exigences :

Configuration matérielle minimale

RAM : 4 Go minimum
Disque : 5 Go minimum
CPU : 2 cœurs minimum

Procédure d’installation via Docker

Vous devez au préalable avoir installé Docker sur votre environnement.

Définition la variables `VERSION`

Définir une variable d'environnement VERSION qui contient le numéro de version que vous souhaitez télécharger. La dernière version stable est: 4.8.26.

Fichier CSV contenant la liste des utilisateurs

export VERSION=4.8.26

Définition des variables d’identification

Définir la variable d'identification IDENTIFIANT et CLE.

Code(shell)
 
export IDENTIFIANT=example.com
export CLE=x15nb163FMjcguvvXHno

💡 Où trouver vos identifiants ?

Les identifiants sont fournis lors de votre souscription par e-mail (objet : [Carto-SI] Identifiant pour télécharger le logiciel). Ils ont une durée de validité limitée.

Installation et lancement

Choisissez le dossier qui contiendra les données de l'application. Dans ce document, le chemin du dossier sera nommé <dossier_data>. Dans les illustrations, le dossier est /home/carto-si.

Sous Linux, dans le terminal, définissez une variable DOSSIER contenant le chemin avec la commande suivante :

Code(bash)
 
DOSSIER=/home/carto-si

Définition de la variable DOSSIER sous Linux.

L'image docker tourne sous le uid 1500. Veuillez faire en sorte que le dossier data soit accessible à ce uid.

Code(bash)
 
mkdir -p $DOSSIER
chown 1500:1500 $DOSSIER

Loggez-vous sur le repository docker de Carto-SI avec :

Code(bash)
 
docker login -u $IDENTIFIANT -p $CLE registry.gitlab.com/c3772/cartosi

Lancez le conteneur docker :

Code(bash)
 
docker run --rm -v $DOSSIER:/carto-si/data -p 80:9327 registry.gitlab.com/c3772/cartosi/carto-si:$VERSION

🔐 Première connexion

Définition des identifiants administrateur

Pour se connecter à Carto-SI, il est nécessaire de définir les identifiants administrateur. Ces identifiants sont spécifiés dans le fichier de configuration se trouvant sur le chemin suivant :

Code(bash)
 
vi $DOSSIER/data/conf/carto-si.properties

Recherchez les lignes :

Code
 
mailadmin : admin@carto-si.com
password : $argon2id$v=19$m=15360,t=2,p=1$7QdBqMuTKFWUC2NINchT

Modifiez le champ password avec un nouveau mot de passe sécurisé, puis redémarrer Carto-SI. Ce nouveau mot de passe sera automatiquement haché. Pensez à copier (dans votre gestionnaire de mot de passe) le mot de passe, car il ne sera plus visible.

Code(bash)
 
systemctl restart carto-si.service

Se connecter

Dans votre Navigateur préféré, connectez-vous au serveur.
Entrez l'email administrateur ( mailadmin du fichier carto-si.properties)
Entrez le mot de passe (saisi dans le fichier de configuration carto-si.properties)
Cliquez sur Connexion

Bienvenue dans Carto-SI ! 🎉

Last modified on February 12, 2026