**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 :
![[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
![[20260227145538.png]]
![[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.

![[20260227145747.png]]