Artifact ID: | a458afe285ee2c5d7410207b285f14513189bdc5 |
---|---|
Page Name: | Installation |
Date: | 2020-10-25 23:37:46 |
Original User: | bohwaz |
Mimetype: | text/x-markdown |
Parent: | 9864d07b6d476b8d3465e0f3f8b7e825a4bd603c (diff) |
Next | 3adf08807a37eeadc8a8dee95aa3a72cc5de5618 |
Installer Garradin
Garradin est disponible en deux distributions différentes :
- En-ligne : nécessite de disposer d'un hébergement web (OVH, Ouvaton, Lautre.net, Infomaniak, etc.) et permet de gérer une association collectivement sur Internet.
- Hors-ligne (paquet .deb) : à installer sur son propre ordinateur sous GNU/Linux. Permet de gérer une association individuellement sans nécessiter d'accès Internet.
Comment installer Garradin en-ligne ?
Voici des procédures d'installation détaillées :
- Installation sous Debian-Ubuntu
- Installation pour l'hébergeur OVH
- Installation sous CentOS/RedHat
- Installation assistée avec Yunohost : dans l'interface d'administration Garradin devrait être dans la liste des applications à installer (détails du paquet)
- Installation avec WampServer sous Windows
Si vous n'êtes pas dans ces cas, suivez ces indications :
Avant d'installer, vérifiez que votre hébergeur dispose bien de PHP dans une version supérieure ou égale à 5.6 et de SQLite3.
- Télécharger la dernière version : téléchargement Garradin (prendre le fichier .tar.bz2)
- Décompresser le fichier dans un répertoire accessible au serveur web
- Positionner un virtual host (aussi appelé "sous-domaine") sur le répertoire
www/
du répertoire de Garradin - Se rendre avec son navigateur sur le virtual host de Garradin pour terminer l'installation
Ça ne fonctionne pas
Sous Debian/Ubuntu, vérifiez que les paquets php
et php-sqlite
sont installés. Si ça ne fonctionne toujours pas, essayez de lancer la commande sudo phpenmod sqlite3
si vous avez PHP 7+, ou sudo php5enmod sqlite3
si vous utilisez encore PHP 5.
Je n'ai pas de Virtual Host / sous-domaine à dédier à Garradin, comment faire ?
Le mieux est d'utiliser un sous-domaine dédié, le fonctionnement de Garradin sans vhost dédié n'est pas supporté officiellement.
En alternative voir la page Installation sans vhost pour des solutions communautaires à ce problème.
J'ai un message "Impossible de détecter le chemin d'accès web"
Cela signifie qu'il n'est pas possible de configurer automatiquement le chemin web d'accès à l'application. C'est notamment le cas chez l'hébergeur Ionos 1and1.
Il vous faut connaître et configurer manuellement le chemin d'accès web.
Par exemple dans l'adresse http://compta.mon-asso.tld/
, le chemin d'accès est /
, (cas où Garradin est installé dans un sous-domaine dédié) et dans l'exemple http://mon-asso.tld/compta/
(installé dans un sous-répertoire), le chemin d'accès est /compta/
.
Une fois que vous avez identifié le chemin d'accès, il faut l'inscrire dans le fichier config.local.php
de cette manière :
<?php
namespace Garradin;
const WWW_URI = "CHEMIN";
Remplacez CHEMIN
par le chemin d'accès identifié précédemment.
Message d'erreur à la sélection de compte ou de membre dans un formulaire
Sur Firefox j'ai un message "Firefox ne peut pas afficher cette page/garradin.monsite.tld n'autorise pas la connexion" lorsque je clique sur le bouton pour sélectionner un compte. Ou dans les navigateurs basés sur Chrome (Vivaldi, Opera, Edge, etc.) j'ai un message "[site web] n’autorise pas la connexion".
À partir de la 1.0.0, Garradin utilise des iframe pour afficher le sélecteur de comptes. Pour des raisons de sécurité, certains serveurs web/hébergeurs désactivent la possibilité d'utiliser des iframes. Il faut pour cela ajouter l'header HTTP :
X-Frame-Options: SAMEORIGIN
Pour Apache, il faut ajouter cette ligne à la configuration de votre vhost :
Header always set X-Frame-Options "SAMEORIGIN"
Pour nginx ajouter ceci :
add_header X-Frame-Options SAMEORIGIN always;
Autres problèmes
Voir la page Problèmes fréquents.
Comment installer Garradin hors-ligne ?
Vous devez disposer d'un ordinateur avec Debian (version Wheezy ou supérieure) ou Ubuntu (version 12.10 Quanta ou supérieure).
- Télécharger le paquet .deb : téléchargement Garradin
- L'installer (soit avec le gestionnaire de paquet soit en ligne de commande en utilisant
sudo apt-get install ./garradin-X.Y.Z.deb
) - Lancer
garradin
en ligne de commande ou via le menu "Applications" (catégorie bureautique) - Pour plus de détails : Fonctionnement hors-ligne