From 5d34b356821a1b95b8966269158a46565e525640 Mon Sep 17 00:00:00 2001 From: Loic Masi Date: Fri, 27 Feb 2026 15:33:32 +0100 Subject: [PATCH] Add installation guides for Gitea and MariaDB on Debian 13 --- Installation Gitea.md | 145 +++++++++++++++++++++++++++++++++++++ Installation de MariaDB.md | 54 ++++++++++++++ 2 files changed, 199 insertions(+) create mode 100644 Installation Gitea.md create mode 100644 Installation de MariaDB.md diff --git a/Installation Gitea.md b/Installation Gitea.md new file mode 100644 index 0000000..e82dc44 --- /dev/null +++ b/Installation Gitea.md @@ -0,0 +1,145 @@ +**Gitea version : 1.25.4** + +**Durée estimé : ~10 minutes** +**Prérequis : Debian 13** +**Ressource** : https://dl.gitea.com/gitea/1.25.4/gitea-1.25.4-linux-amd64 + +Installer sudo de préférence avant d'effectuer la suite de guide + +Première étape, faire la mis à jour des paquets (classique) : + +```bash +sudo apt update && sudo apt -y upgrade +``` + +Puis installer Git afin d'éviter tout problème lors de la suite de l'installation + +```bash +sudo apt install git +``` + +Seconde étape : mettre en place un serveur de base de donnée -> [[Installation de MariaDB]] + +Pour débuter l'installation de gitea, il faut créer un nouvel utilisateur qui servira à exécuter Gitea avec les droits nécessaires : + +```bash +sudo adduser \ + --system \ + --shell /bin/bash \ + --gecos 'Git Version Control' \ + --group \ + --disabled-password \ + --home /home/git \ + git +``` + +Ensuite, il faut créer l'arborescence qui permet à Gitea de fonctionner : + +```bash +mkdir -p /var/lib/gitea/{custom,data,log} +chown -R git:git /var/lib/gitea/ +chmod -R 750 /var/lib/gitea/ +mkdir /etc/gitea +chown root:git /etc/gitea +chmod 770 /etc/gitea +``` + +Gitea n'existe pas en version package apt, il faut donc installer le script qui permet de le télécharger : + +```bash + +wget -O gitea https://dl.gitea.com/gitea/1.25.4/gitea-1.25.4-linux-amd64 +chmod +x gitea +sudo mv gitea /usr/local/bin/gitea +``` + +Vérifier qu'il s'est bien installé : + +```bash +gitea --version +``` + +Maintenant, on va faire en sorte que Gitea soit utilisé en mode service dans notre système. Pour ce faire, il va falloir créer le fichier qui va déterminer à quoi correspond notre service. + +```bash +sudo nano /etc/systemd/system/gitea.service +``` + +Puis coller : +```ini +[Unit] +Description=Gitea +After=network.target mariadb.service +Requires=mariadb.service + +[Service] +Type=simple +User=git +Group=git +WorkingDirectory=/var/lib/gitea/ +ExecStart=/usr/local/bin/gitea web --config /var/lib/gitea/custom/conf/app.ini +Restart=always +Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea + +[Install] +WantedBy=multi-user.target +``` + +Exécuter le service. + +```bash +sudo systemctl daemon-reload +sudo systemctl enable --now gitea +``` + +Vous pouvez vérifier que tout fonctionne grâce à un 'status' : + +```bash +sudo systemctl status gitea +``` + +Super ! Maintenant, configurons la base de données précédemment installer. Créer un fichier de config : + +```bash +sudo nano /etc/gitea/app.ini +``` + +Evidemment, si votre base de données se trouve sur une autre VM, il vous faudra modifier les configuration de connexion : + +```ini +APP_NAME = Gitea +RUN_USER = git +WORK_PATH = /var/lib/gitea + +[server] +PROTOCOL = http +HTTP_ADDR = 0.0.0.0 +HTTP_PORT = 3000 +DOMAIN = 127.0.0.1 +ROOT_URL = http://127.0.0.1:3000/ + +[log] +MODE = console +LEVEL = Info +``` + +Redémarrer le service : + +```bash +sudo systemctl restart gitea +``` + +Si tout s'est bien passé, vous devriez pouvoir acceder à l'interface web de Gitea en entrant @ip:3000 : +![[Pasted image 20260227143655.png]] + +Vous pouvez désormais inscrire vos informations de connexion à la base de données. Pour le titre du site, vous pouvez donc renseigner "2028-DI1-P4-G?" par exemple. + +## Bienvenue sur Gitea + +![[Pasted image 20260227145538.png]] + +Créer désormais votre premier utilisateur, il sera évidemment doter des permissions administrateur afin de pouvoir manager votre application. + +Une fois votre compte activé, alors vous pouvez accéder à votre interface. + +![[Pasted image 20260227145747.png]] \ No newline at end of file diff --git a/Installation de MariaDB.md b/Installation de MariaDB.md new file mode 100644 index 0000000..e08a9a5 --- /dev/null +++ b/Installation de MariaDB.md @@ -0,0 +1,54 @@ + +**Durée estimé : ~3 minutes** +**Prérequis : Debian 13** + +Pas grand chose de compliqué, mais ici vous allez trouver toutes les commandes dans le cadre de la mis en place de Gitea. + +Mis à jour des paquets APT : + +```bash +sudo apt update && sudo apt -y upgrade +``` + +Installation de MariaDb Server (toutes les dépendances seront téléchargés à l'exécution de la commande, si vous êtes sur Debian 13, vous verrez toutes les dépendances nécessaires) + +```bash +sudo apt install -y mariadb-server +``` + +Une fois l'installation terminé, vous pouvez vérifier si le service s'est exécuté à l'aide de la commande suivante : + +```bash +systemctl status mariadb --no-pager +``` + +Vous devriez voir un statut actif, si ce n'est pas le cas, aller voir les logs ;) + +Passons maintenant à la configuration de la base de données. Gitea à besoin d'une base de donnée, il fera les migrations tout seul. Pour ce faire, entré dans MariaDB à l'aide de la commande : + +```bash +sudo mariadb +``` + +Puis, entrer ligne par ligne les requêtes SQL suivante : + +```sql + +CREATE DATABASE gitea CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; + +CREATE USER 'gitea'@'localhost' IDENTIFIED BY 'MotDePasseUltraFort'; + +GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'localhost'; + +FLUSH PRIVILEGES; +EXIT; +``` + +Explication : +- On créer la base de donnée 'gitea' en appliquant une règle de formatage des données en UTF-8 +- On créer l'utilisateur 'gitea' avec le mot de passe 'MotDePasseUltraFort' (à modifier évidemment, avec un mot de passe générer dans votre Keepass) +- On donne ensuite les droits d'accès à l'utilisateur 'gitea' sur la base de données 'gitea' et les tables qu'elle contient. +- On applique la modification des droits de l'utilisateur. +- Puis on sort du terminal MariaDB. + +L'initialisation côté base de donnée est **terminé**.