gitea
From Gentoo Wiki
Resources
This article has some todo items:
Gitea is painless self-hosted git service, a fork of gogs.
Installation
Gitea requires the use of a database backend, the following are supported:
- MariaDB/MySQL
- PostgreSQL
- SQLite <- recommended for small, private installations
USE flags
USE flags for www-apps/gitea A painless self-hosted Git service
+acct
|
User and group management via acct-*/git packages |
+filecaps
|
Use Linux file capabilities to control privilege rather than set*id (this is orthogonal to USE=caps which uses capabilities at runtime e.g. libcap) |
gogit
|
(EXPERIMENTAL) Use go-git variants of Git commands. |
pam
|
Add support for PAM (Pluggable Authentication Modules) - DANGEROUS to arbitrarily flip |
pie
|
Build programs as Position Independent Executables (a security hardening technique) |
sqlite
|
Add support for sqlite - embedded sql database |
Emerge
root #emerge --ask www-apps/giteaConfiguration
Files
- /etc/gitea/app.ini - User configuration file, see bug #714844
- /etc/gitea/custom/conf/app.ini - Recommanded file to edit as said by the documentation inside app.ini (see above).
The path does not exist, create it:
root #mkdir -p /etc/gitea/custom/conf
Warning
Do not, as explained in app.ini, copy the whole file to /etc/giteac/custom/conf/app.ini, instead the user need to picks up what is needed. Look-up for the proper parameters on the gitea cheat-sheet page.
Do not, as explained in app.ini, copy the whole file to /etc/giteac/custom/conf/app.ini, instead the user need to picks up what is needed. Look-up for the proper parameters on the gitea cheat-sheet page.
Service
OpenRC
Starting gitea in the background:
root #rc-service gitea startCurrent status of gitea service:
root #rc-service gitea statusStarting automatically at system boot:
root #rc-update add gitea default
Systemd
Starting gitea in the background:
root #systemctl start giteaCurrent status of gitea service:
root #systemctl status giteaStarting automatically at system boot:
root #systemctl enable giteaUsage
Start and/or enable gitea service.
The web interface should be available at http://localhost:3000/, when running at first time, it should be redirected to http://localhost:3000/install.
Removal
Unmerge
root #emerge --ask --depclean --verbose www-apps/giteaSee also
External resources
- ArchWiki Gitea - can be helpful while configuration sections is incomplete on Gentoo wiki
- Official documentation