From 688d09304c02fabef41a2f2d801cde76b57e7d00 Mon Sep 17 00:00:00 2001
From: Christian MOMON <christian@momon.org>
Date: Thu, 3 Feb 2022 18:35:51 +0000
Subject: [PATCH] Update README.md

---
 README.md | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 69 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 4d5acbf..ac5bee5 100644
--- a/README.md
+++ b/README.md
@@ -115,6 +115,11 @@ server
 
     # StatoolInfos.
     include /etc/nginx/statoolinfos.conf;
+
+    location /
+    {
+        proxy_pass http://localhost:3000;
+    }    
 }
 ``` 
 
@@ -258,7 +263,7 @@ Gitea propose un fichier prêt à l'emploi dont il faut modifier manuellement qu
 
     https://github.com/go-gitea/gitea/blob/master/contrib/systemd/gitea.service
 
-Fichier personnalisé pour la forge April à mettre dans /etc/systemd/system/gitea.service :
+Fichier personnalisé pour la forge Chalec à mettre dans /etc/systemd/system/gitea.service :
 ```
 [Unit]
 Description=Gitea (Git with a cup of tea)
@@ -293,6 +298,67 @@ systemctl enable gitea.service
 systemctl start gitea.service
 ```
 
+## Premier démarrage
+
+Suite au premier démarrage, ouvrir un navigateur web sur le site et cliquer sur « connexion ». Alors une page de configuration générale s'ouvre. La remplir comme suit :
+
+- base de données :
+  - type de base de données : Postgresql
+  - hôte : 127.0.0.1:5432
+  - nom d'utilisateur : giteadba
+  - mot de passe : xxxxxxxxxxxx
+  - nom de la base : giteadb
+  - SSL : Disable
+  - Schéma : vide
+- configuration générale :
+  - titre du site : La forge Chalec
+  - exécuter avec le compte d'un autre utilisateur : git
+  - domaine du serveur SSH : forge.chalec.org
+  - chemin des fichiers log : /var/log/gitea/
+  - laisser les autres valeurs par défaut
+- paramètres facultatifs :
+  - paramètres emails :
+  - hôte SMTP : localhost:25
+  - envoyer les mails en tant que : no-reply@chalec.org
+  - exiger la confirmation de l'email lors de l'inscription : oui
+  - activer les notifications par email : oui
+- paramètres serveurs et tierces parties :
+  - activer le mode hors-ligne : OUI (servira toutes les ressources localement)
+  - désactiver Gravatar : OUI
+  - activer les avatars unifiés : NON
+  - activer l'inscription OpenID : NON
+  - désactiver le formulaire d'inscription : non
+  - n'autoriser l'inscription qu'à partir des services externes : non
+  - activer l'inscription OpenID : non
+  - activer le CAPTCHA : OUI
+  - exiger la connexion à un compte pour afficher les pages : non
+  - masquer les adresses e-mail par défaut : non
+  - autoriser la création d'organisation par défaut : oui
+  - activer le suivi de temps par défaut : NON
+  - paramètres de compte administrateur :
+  - nom :  chalecadmin (admin est refusé par le formulaire)
+  - mot de passe : xxxxxxxxxxx
+  - adresse email : admin@chalec.org
+
+Puis cliquer sur « Installer Gitea ».
+
+
+Un fichier de configuration a été créé dans `/etc/gitea/gitea.ini`. Par la suite, les valeurs pourront être modifiées dans ce fichier.
+
+Précautions :
+```
+chown -R root:git /etc/gitea
+chmod g=rx /etc/gitea
+chmod g=r /etc/gitea/gitea.ini
+```
+
+Vérifier que :
+```
+[server]
+ROOT_URL         = https://forge.chalec.org/
+```
+
+# Personnalisation
 
 ## Licences préférées
 
@@ -311,9 +377,9 @@ Paramétrage dans /etc/gitea/gitea.ini :
 PREFERRED_LICENSES=AGPL-3.0-or-later,GPL-3.0-or-later,CC-BY-SA-4.0
 ```
 
-## Taille maximale de téléversement
+### Taille maximale de téléversement
 
-Par défaut, la taille maximale d'un téléversement est limité à 3 Mo. Pour augmenter la taille (à 20 Mo pour la forge Devinsy), ajouter une section dans /etc/gitea/gitea.ini :
+Par défaut, la taille maximale d'un téléversement est limité à 3 Mo. Pour augmenter la taille (à 20 Mo pour la forge Chalec), ajouter une section dans /etc/gitea/gitea.ini :
 ```
 [repository.upload]
 ; Whether repository file uploads are enabled. Defaults to `true`