Gitea : administration via la commande gitea

La commande gitea administre l’instance en ligne de commande : création de comptes, diagnostic et maintenance.

Prérequis

• Accès shell au serveur Gitea avec l’utilisateur git.
• Le binaire gitea et le chemin du fichier de configuration app.ini.

1. Définir l’environnement

Exécuter en tant qu’utilisateur du service et pointer la configuration :

sudo -u git gitea --config /etc/gitea/app.ini --work-path /var/lib/gitea help

2. Créer un administrateur

sudo -u git gitea admin user create \
  --username admin-exemple \
  --email admin@exemple.fr \
  --random-password \
  --admin \
  --config /etc/gitea/app.ini

Le mot de passe aléatoire est affiché une fois. Forcer son changement à la première connexion avec --must-change-password.

3. Réinitialiser un mot de passe

sudo -u git gitea admin user change-password \
  --username admin-exemple --password "NouveauMotDePasse" \
  --config /etc/gitea/app.ini

4. Diagnostiquer avec doctor

sudo -u git gitea doctor check --all --config /etc/gitea/app.ini

Pour appliquer les corrections automatiques :

sudo -u git gitea doctor check --all --fix --config /etc/gitea/app.ini

5. Régénérer hooks et clés

sudo -u git gitea admin regenerate hooks --config /etc/gitea/app.ini
sudo -u git gitea admin regenerate keys --config /etc/gitea/app.ini

Vérification

Lister les comptes :

sudo -u git gitea admin user list --config /etc/gitea/app.ini

Le nouvel administrateur apparaît avec la colonne IsAdmin à true.

Dépannage

• « unable to open database » : mauvais --work-path ou --config ; aligner sur les chemins du service systemd.
• Commande exécutée en root : les fichiers prennent de mauvais droits ; toujours utiliser sudo -u git.
• doctor signale des hooks manquants : lancer gitea admin regenerate hooks.
• Mot de passe rejeté : longueur ou complexité insuffisante selon [security] dans app.ini.