Overview

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
Content

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 :

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