--- description: Créer son compte sur le Git d'Alpinux (Forgejo), y héberger ses propres dépôts, et y envoyer son travail en SSH ou en HTTPS. --- # Le Git d'Alpinux L'association héberge sa propre **forge logicielle** à l'adresse **[gitea.alpinux.org](https://gitea.alpinux.org)**. C'est l'équivalent associatif de GitHub ou GitLab : un endroit où déposer du code, le versionner, le partager, suivre des tickets. Elle est ouverte aux membres pour leurs **projets personnels** : un script bricolé un dimanche, la configuration de sa machine, les sources d'un site, des notes — tout ce qui gagne à être versionné et à ne pas vivre uniquement sur un disque dur. !!! info "Gitea ou Forgejo ?" L'adresse dit `gitea`, la page affiche *Forgejo*. Forgejo est la suite du projet Gitea, dont il est issu ; l'adresse historique a été conservée. Si une documentation trouvée sur Internet parle de Gitea, elle s'applique presque toujours telle quelle. --- ## Créer son compte **Il n'y a pas d'inscription directe sur la forge** : le formulaire est désactivé et affiche *« Registration is disabled »*. C'est normal. Tous les comptes passent par **AlpID**, l'authentification unique de l'association — un seul identifiant pour la forge, le wiki, le cloud et les autres services. ### 1. Créer son compte AlpID 1. Allez sur **[https://alpid.alpinux.org](https://alpid.alpinux.org)**. 2. Cliquez sur **« Créer un compte »** (ou *Register*). 3. Remplissez le formulaire : - **Nom d'utilisateur** : simple, sans accent ni espace (ex. `prenom.nom`) — il servira aussi d'adresse à vos dépôts ; - **Adresse e-mail** : une adresse que vous consultez régulièrement ; - **Mot de passe** : au moins 8 caractères. 4. Validez, puis cliquez sur le lien de confirmation reçu par courriel. !!! note "Déjà membre ?" Si vous avez déjà un compte sur le portail membres ou le cloud de l'association, c'est le même : inutile d'en créer un second, passez directement à l'étape suivante. ### 2. Première connexion à la forge 1. Allez sur **[https://gitea.alpinux.org](https://gitea.alpinux.org)**. 2. Cliquez sur **« Connexion »** en haut à droite. 3. Choisissez **« Se connecter avec AlpID »**. 4. AlpID confirme votre identité et vous ramène sur la forge. Votre compte y est créé automatiquement à cette première connexion : vous avez maintenant votre espace, à l'adresse `gitea.alpinux.org/votre-nom-dutilisateur`. --- ## Créer son premier dépôt 1. En haut à droite, cliquez sur **+** puis **Nouveau dépôt**. 2. Remplissez : | Champ | Conseil | |---|---| | **Nom du dépôt** | court, en minuscules, sans espace — `mes-scripts`, `config-i3` | | **Description** | une phrase : dans six mois, elle vous rappellera de quoi il s'agit | | **Visibilité** | **Privé** dans le doute : un dépôt se rend public plus tard, l'inverse n'efface pas ce qui a été vu | | **Initialiser avec un README** | oui — un dépôt vide est pénible à cloner | | **.gitignore** | choisissez le modèle correspondant à votre langage | | **Licence** | pour un projet destiné à être partagé, la GPL ou la MIT selon vos préférences | 3. **Créer le dépôt**. --- ## Y envoyer son travail Deux façons de vous authentifier. La clé SSH est à configurer une fois pour toutes ; le jeton HTTPS dépanne partout. ### Par clé SSH (recommandé) Générez une clé si vous n'en avez pas déjà une : ```bash ssh-keygen -t ed25519 -C "prenom@ma-machine" ``` Acceptez le chemin proposé et choisissez une phrase de passe. Affichez la partie **publique** — celle qui se termine par `.pub`, la seule qui se partage : ```bash cat ~/.ssh/id_ed25519.pub ``` Copiez la ligne entière, puis sur la forge : votre avatar → **Paramètres** → **Clés SSH / GPG** → **Ajouter une clé**. Donnez-lui un nom qui identifie la machine (`portable`, `tour-du-salon`), collez, validez. Vérifiez : ```bash ssh -T git@gitea.alpinux.org ``` La forge répond `Hi there, votre-nom !… Forgejo does not provide shell access` — c'est le message attendu : l'authentification fonctionne, et la forge ne donne pas d'accès au shell, ce qui est voulu. Vous pouvez alors cloner et pousser : ```bash git clone git@gitea.alpinux.org:votre-nom/mes-scripts.git ``` ### Par HTTPS avec un jeton Utile depuis une machine où vous ne voulez pas déposer de clé, ou pour un script. 1. Avatar → **Paramètres** → **Applications** → **Générer un nouveau jeton**. 2. Donnez-lui un nom parlant et **cochez seulement les portées nécessaires** — pour pousser du code, `repository` suffit. 3. Copiez le jeton : **il ne sera plus affiché ensuite**. Le jeton remplace le mot de passe : ```bash git clone https://gitea.alpinux.org/votre-nom/mes-scripts.git # utilisateur : votre nom d'utilisateur # mot de passe : le jeton ``` !!! danger "Un jeton est un mot de passe" Ne le placez jamais dans un fichier versionné, ni dans l'URL d'un dépôt que vous partagez. S'il vous échappe, révoquez-le depuis la même page : il cesse immédiatement de fonctionner. --- ## Quelques repères **Ce qui n'a pas sa place dans un dépôt** : mots de passe, jetons, clés privées, fichiers `.env`. Une fois poussé, un secret reste dans l'historique même après suppression du fichier — il faut le considérer comme compromis et le changer. Les gros fichiers binaires (vidéos, machines virtuelles) n'y ont pas leur place non plus : git conserve chaque version, le dépôt gonfle et ne dégonfle jamais. **Gardez une copie ailleurs.** La forge est un service rendu par des bénévoles, pas un service de sauvegarde. Un dépôt cloné sur votre machine *est* une copie complète de l'historique : c'est déjà une bonne assurance. **Public ou privé ?** Un dépôt public est lisible par tout Internet, moteurs de recherche compris. Privé par défaut, publié quand c'est prêt : c'est le sens de la marche. --- ## Et pour le wiki ? Le wiki que vous lisez est lui-même hébergé sur cette forge. Pour y contribuer — corriger une faute, proposer un article — la marche à suivre est décrite dans [Contribuer au wiki](../contribuer/index.md). ## Une question ? Posez-la lors d'une [rencontre Alpinux](../alpinux/evenements.md) : la forge est un service de l'association, les bénévoles sont les mieux placés pour vous aider à démarrer.