107 lines
1.9 KiB
Markdown
107 lines
1.9 KiB
Markdown
|
---
|
||
|
|
title: "Gitea"
|
||
|
|
weight: 1
|
||
|
|
# bookFlatSection: false
|
||
|
|
# bookToc: true
|
||
|
|
# bookHidden: false
|
||
|
|
# bookCollapseSection: false
|
||
|
|
# bookComments: false
|
||
|
|
# bookSearchExclude: false
|
||
|
|
---
|
||
|
|
|
||
|
|
# Gitea
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
Install `gitea` package.
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
Configuration takes place in `/etc/gitea/app.ini`. Examples are provided at
|
||
|
|
`/etc/gitea/app.example.ini`.
|
||
|
|
|
||
|
|
### Server
|
||
|
|
Server configuration.
|
||
|
|
```
|
||
|
|
[server]
|
||
|
|
PROTOCOL = unix
|
||
|
|
DOMAIN = git.edgarpierre.fr
|
||
|
|
ROOT_URL = https://git.edgarpierre.fr/
|
||
|
|
STATIC_URL_PREFIX =
|
||
|
|
HTTP_ADDR = /run/gitea/gitea.socket
|
||
|
|
SSH_PORT = ***
|
||
|
|
OFFLINE_MODE = true
|
||
|
|
ENABLE_GZIP = true
|
||
|
|
ALLOW_GRACEFUL_RESTARTS = true
|
||
|
|
```
|
||
|
|
|
||
|
|
#### LFS
|
||
|
|
```
|
||
|
|
LFS_START_SERVER = true
|
||
|
|
LFS_JWT_SECRET =
|
||
|
|
```
|
||
|
|
|
||
|
|
### Database
|
||
|
|
Create user and database for `gitea` using postgres.
|
||
|
|
|
||
|
|
To use a unix socket connection to postgres, configuration should be :
|
||
|
|
```
|
||
|
|
[database]
|
||
|
|
DB_TYPE = postgres
|
||
|
|
HOST = /run/postgresql/
|
||
|
|
NAME = gitea
|
||
|
|
USER = gitea
|
||
|
|
```
|
||
|
|
|
||
|
|
### Security
|
||
|
|
```
|
||
|
|
[security]
|
||
|
|
INSTALL_LOCK = true
|
||
|
|
SECRET_KEY = ***
|
||
|
|
INTERNAL_TOKEN = ***
|
||
|
|
REVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128
|
||
|
|
```
|
||
|
|
|
||
|
|
```
|
||
|
|
[oauth2]
|
||
|
|
ENABLE = false
|
||
|
|
```
|
||
|
|
|
||
|
|
```
|
||
|
|
[service]
|
||
|
|
DISABLE_REGISTRATION = true
|
||
|
|
```
|
||
|
|
|
||
|
|
### Logs
|
||
|
|
```
|
||
|
|
[log]
|
||
|
|
ROOT_PATH = /var/log/gitea
|
||
|
|
```
|
||
|
|
|
||
|
|
### Repositories
|
||
|
|
```
|
||
|
|
[repository]
|
||
|
|
ROOT = /var/lib/gitea/repos
|
||
|
|
DEFAULT_BRANCH = main
|
||
|
|
```
|
||
|
|
|
||
|
|
### Email
|
||
|
|
```
|
||
|
|
[mailer]
|
||
|
|
ENABLED = true
|
||
|
|
SUBJECT_PREFIX = [Gitea]
|
||
|
|
HOST = edgarpierre.fr:465
|
||
|
|
FROM = gitea@edgarpierre.fr
|
||
|
|
USER = gitea
|
||
|
|
PASSWD = ***
|
||
|
|
SEND_AS_PLAIN_TEXT = true
|
||
|
|
MAILER_TYPE = smtp
|
||
|
|
```
|
||
|
|
|
||
|
|
### Webhooks
|
||
|
|
```
|
||
|
|
[webhook]
|
||
|
|
ALLOWED_HOST_LIST = loopback,edgarpierre.fr,*.edgarpierre.fr
|
||
|
|
```
|
||
|
|
|
||
|
|
## Service
|
||
|
|
Gitea is started using systemd service `gitea.service`.
|