diff --git a/INSTALL.md b/INSTALL.md index 93cce82..d524982 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,44 +1,47 @@ -Initial requirements +Pré-requis ==================== +Installer les paquets suivants : ``` # apt install screen ``` -Create DB +Base de données (BDD) ========= +Installer la base de données et démarrer le service : ``` # apt install postgresql postgresql-client # systemctl enable --now postgresql ``` -Check /etc/postgresql/xx/main/pg_hba.conf for localhost contains +On vérifie que l'on peut se connecter en IP avec vérification du mot de passe par la BDD. Editer le fichier suivant : +/etc/postgresql/xx/main/pg_hba.conf ``` host all all 127.0.0.0/24 md5 ``` +On crée l'utilisateur avec le mot de passe , et la base ``` # su - postgres -$ createuser -$ createdb -O -$ psql - ALTER USER WITH PASSWORD ' ; +$ createuser +$ createdb -O +$ psql + ALTER USER WITH PASSWORD '' ; ALTER ROLE; \q ``` -Install Etherpad-lite +Installer Etherpad-lite ===================== -Add etherpad user - +Ajouter l'utilisateur etherpad ``` # adduser etherpad # su - etherpad && cd ``` -Install and run etherpad +Suivre les recommandations etherpad-lite pour installer sur Debian : ``` # curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - # apt install -y nodejs @@ -46,7 +49,74 @@ $ git clone --branch master https://github.com/ether/etherpad-lite.git $ cd etherpad-lite ``` -Restore "etherpad/settings.json" in etherpad-lite +Configuration Etherpad-lite +===================== + +Edition du settings.json + + +BDD +Commenter la BDD par défaut : +``` +/* + "dbType": "dirty", + "dbSettings": { + "filename": "var/dirty.db" + }, +*/ +``` +Renseigner les paramètres de la BDD postgres + +``` + "dbType" : "postgres", + "dbSettings" : { + "user": "", + "host": "localhost", + "port": 5432, + "password": "", + "database": "", + "charset": "utf8mb4" + }, +``` + + +Personnalisation de l'instance +``` + "title": "Pad Chalec", +``` +``` + "favicon": "../pad.chalec.org.svg", +``` +``` + "skinName": "chalec", +``` +``` +"defaultPadText" : " <---- Tapez votre texte ici et libre à vous d'effacer cette \ +page d'informations.\n\nBienvenue sur pad.chalec.org, un service Chalec, basé sur le \ +logiciel libre Etherpad-lite !\n\nNous vous souhaitons une agréable navigation ainsi \ +que de partager les valeurs du libre ici ou ailleurs.\n\nQuelques conseils : \n- cons\ +ervez pour vous-même l'adresse (URL) de ce pad et communiquez-la à vos collaborateurs\ +. Le contenu est synchronisé entre participants ;\n- attention, tout est public ! Mai\ +s sans adresse (URL) point d'accès. Ne la partagez pas avec n'importe qui ;\n- choisi\ +ssez un pseudonyme et une couleur (bouton en haut à droite) afin que les participants\ + puissent identifier l'utilisateur faisant les modifications.\n\nPolitique de conserv\ +ation et de suppression des données : \n- effacement à J+6 mois : votre pad est susce\ +ptible d'être effacé six mois après la date de dernière modification (utiliser les fo\ +nctions d'export si nécessaire) ;\n- nous ne traitons pas de demandes de suppression \ +autres que pour des motifs règlementés par la loi française. En effet, nous ne pouvon\ +s pas assurément vous identifier comme le propriétaire d'un pad !\n\nConditions Génér\ +ales d'Utilisation : \nEn utilisant ce service, vous acceptez tacitement les Conditio\ +ns Générales d'Utilisation (CGU) des services Chalec (https://www.chalec.org/CGU) qui\ + régissent formellement le service et priment sur toutes autres explications fournies\ + sur cette page.\n\nLibrement, \nL'équipe Chalec (https://www.chalec.org),\nCandidat \ +CHATONS par Libre en Communs (https://a-lec.org)\nmailto:contact+pad@chalec.org\nxmpp\ +:chalec@salons.a-lec.org?join", +``` + +Configuration de la BDD : + + + Then try to start etherpad