Installation¶
- orphan
L’installation de Galette est un processus web (une fois les étapes de préparation effectuées). Rendez-vous sur http://localhost/galette. Le processus de mise à jour est documenté séparément.
Vous devriez vous baser sur la dernière release stable, mais il est aussi possible (si vous savez ce que vous faites, cela peut s’avérer plus complexe pour les non développeurs !) de récupérer le code source
Activer l’installeur¶
Nouveau dans la version 1.3.0.
Pour des raisons de sécurité, l’installateur ne fait rien sans que vous ne lui demandiez. Il reste fermé tant qu’un fichier nommé ENABLE_INSTALL est absent du dossier 
data de Galette :
Créer ce fichier vide sur le serveur, puis recharger la page :
$ touch /path/to/galette/data/ENABLE_INSTALL
Le créer prouve que vous avez accès au serveur, ce qu’un visiteur de passage n’a pas.
Galette supprime le fichier par lui-même une fois l’installation - ou la mise à jour - terminée, l’installateur se ferme à nouveau derrière vous. Cela nécessite un accès en écriture sur le répertoire data, qui ne fait pas partie des répertoires dans lesquels Galette a besoin d’écrire. S’il est lu seulement pour le serveur web, la dernière étape affiche un avertissement à la place: supprimez le fichier à la main, l’installation est quand même complète.
Note
C’est l’absence du fichier qui ferme l’installateur, et c’est volontaire : le perdre ne peut que fermer l’installateur, il ne peut jamais l’ouvrir.
Installation ou mise à jour ?¶
Modifié dans la version 1.3.0: Galette ne le demande plus, et l’étape correspondante a été supprimée.
Le mode est déduit du fichier 
config/config.inc.php : pas de fichier de configuration signifie une nouvelle installation, un existant signifie un mise à jour.
Avertissement
Pour installer une nouvelle instance sur une instance existante - tout en effaçant ses données - supprimez le fichier de configuration d’abord. Tant qu’il est là, Galette ne proposera que de mettre à jour.
Vérifications¶
Vérifiez les points suivants pour que Galette tourne sans problèmes :
votre version de PHP est suffisamment récente,
le fuseau horaire PHP est défini (requis depuis PHP 5.3),
toutes les extensions requises sont installées et actives,
certains dossiers demandent un accès en écriture.
Si une des extensions requises est manquante ou si le fuseau horaire n’est pas défini, veuillez contacter votre administrateur. Galette ne requiert aucune extension « exotique ».
La toute première étape de l’installation vérifiera ces points, et vous informera des éventuels problèmes.
Si toutes les étapes de préparation ont été suivies correctement, les droits devraient être bons, veuillez vous référer à la section relative aux droits des fichiers et rafraichissez la page dans votre navigateur.
Base de données¶
Tout d’abord, assurez vous que la base existe, et préparez toutes les informations nécessaires :
nom de l’hôte
nom d’utilisateur de la base de données
mot de la passe de l’utilisateur de la base de données
nom de la base de données
type de base de données (MariaDB/MySQL ou PostgreSQL)
Paramètres de base de données¶
Sur cet écran, choisissez le type de base de données, entrez un nom d’hôte, un utilisateur et un mot de passe. Le préfixe des tables est utile si votre base de données n’est pas dédiée à Galette, les propositions par défaut devraient convenir, mais vous pouvez les changer :)
Note
Cette étape est n’est affichée que pour une nouvelle installation. Lors de la mise à jour, tout - mot de passe inclus - est lu dans le fichier de configuration existant, et l’étape est sautée. Elle ne revient que si ce fichier ne peut être lu, ou s’il est incomplet.
Vérifications¶
L’écran suivant essaiera de se connecter à la base de données avec les éléments founis, et vérifiera ensuite que les droits d’accès sont corrects (l’utilisateur peut ajouter/supprimer/modifier de tables et peut ajouter/supprimer/modifier des lignes).
S’il y a une erreur de connexion, retournez à la page précédente, corrigez votre configuration, et essayez de nouveau. Si vous voyez des problèmes de droits, corrigez les sur votre serveur et utilisez le bouton « Rafraichir ».
Création des tables¶
Note
Ces instructions ne sont valables que pour une nouvelle installation Lors d’une mise à jour, la base de données existe déjà.
Si une connexion à la base de données à pu être établie, et que tout est correct, le système d’installation va maintenant créer les tables et insérer les valeurs par défaut. Vous pouvez voir les tables créées depuis n’importe quel outil graphique ou en ligne de commande :
MariaDB :
mysql> use mygalette; mysql> show tables;
PostgreSQL :
postgres=# \c mygalette postgres=# \dt
Paramètres administrateur¶
Note
Cet écran est affiché à l’installation uniquement. Lors d’une mise à jour, le super administrateur existe déjà.
L’écran suivant vous demandera les information de l’utilisateur super administrateur de Galette. À l’utilisation, vous pouvez définir certains adhérents de Galette comme administrateurs, mais celui créé à l’installation n’est pas un membre, ne peut être supprimé, et possède des droits que n’ont aucun des autres.
Télémétrie¶
Pour en savoir davantage sur les instances de Galette installées, nous collectons des données anonymes. Vous pouvez également vous enregistrer en tant qu’utilisateur de Galette :)
Initialiser¶
La dernière étape écrit le fichier de configuration au besoin, supprime le fichier ENABLE_INSTALL, et initialise des valeurs par défaut dans votre base, par exemple :
ajout des préférences par défaut de Galette
ajout des types de contributions et des status pa défaut,
configuration des champs et permissions,
textes pour les courriels administratifs,
statuts des adhérents par défaut,
modèles PDF par défaut
…
Lors d’une mise à jour, seules les préférences manquantes et les nouvelles données seront prises en charge.
Fin de l’installation¶
L’installation est terminée, félicitations !
Vous pouvez maintenant vous connecter à Galette, en utilisant les identifiants super administrateur renseignés à l’installation. Rendez-vous maintenant au manuel de l’utilisateur de Galette.
Bonne Galette !