Binary

Canaille fournit un fichier exécutable unique prêt à l’emploi pour Linux. L’installation binaire est le moyen le plus simple d’obtenir une version de Canaille prête pour la production, bien qu’elle ne soit pas la plus personnalisable. C’est généralement la méthode recommandée pour utiliser Canaille en production.

$ wget https://github.com/yaal-coop/canaille/releases/download/0.2.7/canaille -o canaille
$ chmod +x canaille

Note

L’exécutable de Canaille offre de moins bonnes performances au démarrage que les autres méthodes. Ça n’est généralement pas un problème, puisque Canaille est utilisé comme un processus à longue durée de vie, mais si c’est important pour vous, vous voudriez sans doute choisir une autre méthode d’installation.

Then you can run the Canaille web service with:

$ ./canaille run

Installer

The install command will apply most of the things needed to get Canaille working. Depending on the configured database it will create the SQL tables, or install the LDAP schemas for instance.

$ ./canaille install

Vérifier

After installation, you can test the network parameters in your configuration file using the config check command. It will attempt to connect your SMTP server, or your SMPP server if defined.

$ ./canaille config check

Créer le premier utilisateur

Une fois Canaille installé, vous allez assez rapidement avoir besoin d’ajouter des utilisateurs. Pour créer votre premier utilisateur, vous pouvez utiliser la ligne de commande canaille create.

$ ./canaille create user \
    --user-name admin \
    --password admin \
    --emails admin@mydomain.example \
    --given-name George \
    --family-name Abitbol \
    --formatted-name "George Abitbol"