# Forgejo pour YunoHost [](https://dash.yunohost.org/appci/app/forgejo)   [](https://install-app.yunohost.org/?app=forgejo) *[Read this readme in english.](./README.md)* > *Ce package vous permet d'installer Forgejo rapidement et simplement sur un serveur YunoHost. Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l'installer et en profiter.* ## Vue d'ensemble Forgejo is a Gitea fork (which is a Gogs fork). A self-hosted Git service written in Go. Alternative to GitHub / Gitlab. **Version incluse :** 1.18.0-1~ynh1 ## Captures d'écran  ## Avertissements / informations importantes ## Additional informations ### Notes on SSH usage If you want to use Forgejo with SSH and be able to pull/push with your SSH key, your SSH daemon must be properly configured to use private/public keys. Here is a sample configuration `/etc/ssh/sshd_config` that works with Forgejo: ```bash PubkeyAuthentication yes AuthorizedKeysFile /home/yunohost.app/%u/.ssh/authorized_keys ChallengeResponseAuthentication no PasswordAuthentication no UsePAM no ``` You must also add your public key to your Forgejo profile. When using SSH on any port other than 22, you need to add these lines to your SSH configuration `~/.ssh/config`: ```bash Host domain.tld port 2222 # change this with the port you use ``` ### Upgrade By default, a backup is performed before upgrading. To avoid this, you have the following options: - Pass the `NO_BACKUP_UPGRADE` env variable with `1` at each upgrade. For example `NO_BACKUP_UPGRADE=1 yunohost app upgrade forgejo`. - Set `disable_backup_before_upgrade` to `1`. You can set it with this command: `yunohost app setting forgejo disable_backup_before_upgrade -v 1` After that, the settings will be applied for **all** the next updates. From command line: `yunohost app upgrade forgejo` ### Backup This application now uses the core-only feature of the backup. To keep the integrity of the data and to have a better guarantee of the restoration it is recommended to proceed as follows: - Stop Forgejo service with this command: `systemctl stop forgejo.service` - Launch Forgejo backup with this command: `yunohost backup create --app forgejo` - Backup your data with your specific strategy (could be with rsync, borg backup or just cp). The data is generally stored in `/home/yunohost.app/forgejo`. - Restart Forgejo service with theses command: `systemctl start forgejo.service` ### Remove Due of the backup core only feature the data directory in `/home/yunohost.app/forgejo` **is not removed**. It must be manually deleted to purge user data from the app. ### LFS setup To use a repository with an `LFS` setup, you need to activate it on `/opt/forgejo/custom/conf/app.ini` ```ini [server] LFS_START_SERVER = true LFS_HTTP_AUTH_EXPIRY = 20m ``` By default, NGINX is configured with a maximum value for uploading files at 200 MB. It's possible to change this value on `/etc/nginx/conf.d/my.domain.tld.d/forgejo.conf`. ``` client_max_body_size 200M; ``` Don't forget to restart Forgejo `sudo systemctl restart forgejo.service`. > These settings are restored to the default configuration when updating Forgejo. Remember to restore your configuration after all updates. ### Git command access with HTTPS If you want to use the Git command (like `git clone`, `git pull`, `git push`), you need to set this app as **public**. ## Documentations et ressources * Site officiel de l'app : * Documentation officielle de l'admin : * Dépôt de code officiel de l'app : * Documentation YunoHost pour cette app : * Signaler un bug : ## Informations pour les développeurs Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/forgejo_ynh/tree/testing). Pour essayer la branche testing, procédez comme suit. ``` bash sudo yunohost app install https://github.com/YunoHost-Apps/forgejo_ynh/tree/testing --debug ou sudo yunohost app upgrade forgejo -u https://github.com/YunoHost-Apps/forgejo_ynh/tree/testing --debug ``` **Plus d'infos sur le packaging d'applications :**