mirror of
https://framagit.org/YunoHost-Apps/gitea_ynh.git
synced 2024-11-22 02:51:35 +01:00
126 lines
3.7 KiB
Markdown
126 lines
3.7 KiB
Markdown
Gitea package for YunoHost
|
|
==========================
|
|
|
|
|
|
[](https://dash.yunohost.org/appci/app/gitea)  
|
|
[](https://install-app.yunohost.org/?app=gitea)
|
|
|
|
> *This package allow you to install gitea quickly and simply on a YunoHost server.
|
|
If you don't have YunoHost, please see [here](https://yunohost.org/#/install) to know how to install and enjoy it.*
|
|
|
|
Overview
|
|
--------
|
|
|
|
Gitea is a fork of Gogs a self-hosted Git service written in Go. Alternative to Github.
|
|
|
|
**Shipped version:** 1.12.2
|
|
|
|
Screenshots
|
|
-----------
|
|
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
* Official documentation: https://docs.gitea.io/
|
|
* YunoHost documentation: There no other documentations, feel free to contribute.
|
|
|
|
YunoHost specific features
|
|
--------------------------
|
|
|
|
### Multi-users support
|
|
|
|
LDAP and HTTP auth are supported.
|
|
|
|
### Supported architectures
|
|
|
|
* x86-64 - [](https://ci-apps.yunohost.org/ci/apps/gitea/)
|
|
* ARMv8-A - [](https://ci-apps-arm.yunohost.org/ci/apps/gitea/)
|
|
|
|
<!--Limitations
|
|
------------
|
|
|
|
* Any known limitations.
|
|
-->
|
|
|
|
Additional informations
|
|
-----------------------
|
|
|
|
### 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 /home/%u/.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`.
|
|
|
|
### LFS setup
|
|
To use a repository with an `LFS` setup, you need to activate-it on `/opt/gitea/custom/conf/app.ini`
|
|
```ini
|
|
[server]
|
|
LFS_START_SERVER = true
|
|
LFS_HTTP_AUTH_EXPIRY = 20m
|
|
```
|
|
By default Nginx is setup with a max value to updload files at 200 Mo. It's possible to change this value on `/etc/nginx/conf.d/my.domain.tld.d/gitea.conf`.
|
|
```
|
|
client_max_body_size 200M;
|
|
```
|
|
Don't forget to restart Gitea `sudo systemctl restart gitea.service`.
|
|
|
|
> This settings are restored to the default config when Gitea is updated. Don't forget to restore your setup 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**.
|
|
|
|
Links
|
|
-----
|
|
|
|
* Report a bug: https://framagit.org/YunoHost-Apps/gitea_ynh/issues
|
|
* App website: http://gitea.io
|
|
* YunoHost website: https://yunohost.org/
|
|
|
|
---
|
|
|
|
Install
|
|
-------
|
|
|
|
From command line:
|
|
|
|
`sudo yunohost app install -l gitea https://github.com/YunoHost-Apps/gitea_ynh`
|
|
|
|
Upgrade
|
|
-------
|
|
|
|
From command line:
|
|
|
|
`sudo yunohost app upgrade gitea -u https://github.com/YunoHost-Apps/gitea_ynh`
|
|
|
|
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.
|
|
|
|
Todo
|
|
----
|