mirror of
https://framagit.org/YunoHost-Apps/gitea_ynh.git
synced 2024-11-21 18:41:35 +01:00
70 lines
2.2 KiB
Markdown
70 lines
2.2 KiB
Markdown
# Gitea package for YunoHost
|
|
|
|
Gitea is a fork of Gogs a self-hosted Git service written in Go. Alternative to Github.
|
|
- [Gitea website](http://gitea.io)
|
|
|
|
[](https://ci-apps.yunohost.org/jenkins/job/gitea%20%28Community%29/lastBuild/consoleFull)
|
|
|
|
[](https://install-app.yunohost.org/?app=gitea)
|
|
|
|
## Requirements
|
|
A functional instance of [YunoHost](https://yunohost.org)
|
|
|
|
## Installation
|
|
From the command-line:
|
|
|
|
`sudo yunohost app install https://github.com/YunoHost-Apps/gitea_ynh`
|
|
|
|
## Upgrade
|
|
From the command-line:
|
|
|
|
`sudo yunohost app upgrade Gitea -u https://github.com/YunoHost-Apps/gogs_ynh gogs`
|
|
|
|
## Notes on SSH usage
|
|
If you want to use Gitea with ssh and be able to pull/push with you ssh key, your ssh daemon must be properly configured to use private/public keys. Here is a sample configuration of `/etc/ssh/sshd_config` that works with Gitea:
|
|
|
|
```bash
|
|
PubkeyAuthentication yes
|
|
AuthorizedKeysFile %h/.ssh/authorized_keys
|
|
ChallengeResponseAuthentication no
|
|
PasswordAuthentication no
|
|
UsePAM no
|
|
```
|
|
|
|
You also need to add your public key to your Gitea profile.
|
|
|
|
If you use ssh on another port than 22, you need to add theses lines to your ssh config in `~/.ssh/config`:
|
|
|
|
```bash
|
|
Host domain.tld
|
|
port 2222 # change this with the port you use
|
|
```
|
|
|
|
|
|
Architecture: this package is compatible with amd64, i386 and arm. The package will try to detect it with the command uname -m and fail if it can't detect the architecture. If that happens please open an issue describing your hardware and the result of the command `uname -m`.
|
|
|
|
## Issue
|
|
|
|
Any issue is welcome here : https://github.com/YunoHost-Apps/gogs_ynh/issues
|
|
|
|
## License
|
|
Gitea is published under the MIT License:
|
|
https://github.com/go-gitea/gitea/blob/master/LICENSE
|
|
|
|
This package is published under the MIT License.
|
|
|
|
|
|
## Developper info
|
|
Please do your pull requests to the `dev` branch.
|
|
|
|
Test or upgrade to dev version:
|
|
```bash
|
|
sudo su - admin
|
|
git clone -b dev https://github.com/YunoHost-Apps/gogs_ynh
|
|
# to install
|
|
sudo yunohost app install -l Gogs /home/admin/gogs_ynh
|
|
# to upgrade
|
|
sudo yunohost app upgrade -f /home/admin/gogs_ynh gogs
|
|
|
|
```
|