Overview

Artifact ID: 5a2cc51034c811c485b7b9b7617fc0eeabbb4b8a
Page Name:Installation
Date: 2020-11-23 16:29:32
Original User: bohwaz
Mimetype:text/x-markdown
Parent: 99e72655b17ec554cdf0033737a9e80b9abe4a0f (diff)
Next 8775a0015b08a73b52f82f5bb9f4b132be61ed1a
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 ?

Je suis chez un hébergeur commercial ou associatif

Je suis chez un aute hébergeur

Avant d'installer, vérifiez que votre hébergeur dispose bien de PHP dans une version supérieure ou égale à 7.2 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" ou "site" selon les hébergeurs), par exemple gestion.mon-asso.fr 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 (par exemple http://gestion.mon-asso.fr)

Je suis en auto-hébergement

Problèmes courants

Ç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 ouvrir cette page" 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 ?

Voir fonctionnement hors-ligne.