BrainwreckedTech: /* Server Settings */ Added Nginx Reverse Proxy Configuration

2019-12-27T13:31:03Z

Server Settings: Added Nginx Reverse Proxy Configuration

@@ Line 50: / Line 50: @@
 ; Do not set this variable if PROTOCOL is set to 'unix'.
 ;LOCAL_ROOT_URL = https://<your.tld>/
 </nowiki>}}

BrainwreckedTech: Created Gitea page

2019-12-27T13:24:23Z

Created Gitea page

New page

<div style="float:right;margin-left:0.5em;margin-bottom:0.5em;">__TOC__</div>

= Prerequisites =

; [[:Category:Database|Database]]
: For storing repository data.

= Wanted By =

None

= Installation =

{{bc|sudo pacman -Syu gitea}}

= Configuration =

== Server Name ==

You can change the name that displays in every page title

{{hc|/etc/gitea/app.ini|2=<nowiki>
APP_NAME = <My Gitea Server>
</nowiki>}}

== Theme ==

Gitea comes with two themes.

{{hc|/etc/gitea/app.ini|2=<nowiki>
[ui]
DEFAULT_THEME = <arc-green|gitea>
</nowiki>}}

== Server Settings ==

There are 3 main types of server setup:

# Direct http access (listen on port 80/443)
# Proxied http access (default is to listen on port 3000)
# Proxied access using UNIX sockets

{{hc|/etc/gitea/app.ini|2=<nowiki>
[server]
PROTOCOL = <http|unix>
DOMAIN = <your.tld>
ROOT_URL = https://<your.tld>/
HTTP_ADDR = {<ip-address>|</path/to/socket>}
HTTP_PORT = {3000|80|<port>}
; Do not set this variable if PROTOCOL is set to 'unix'.
;LOCAL_ROOT_URL = https://<your.tld>/
</nowiki>}}

== SSH Setup ==

If you have your system's SSH port set at something other than the default port 22, you probably want to enable Gitea's internal SSH server so it can listen in on port 22.

{{hc|/etc/gitea/app.ini|2=<nowiki>
[server]
START_SSH_SERVER = true
</nowiki>}}

Set the SSH domain

{{hc|/etc/gitea/app.ini|2=<nowiki>
[server]
SSH_DOMAIN = <your.tld>
</nowiki>}}

== Large File Support ==

{{hc|/etc/gitea/app.ini|2=<nowiki>
[server]
LFS_START_SERVER = <false|true>
LFS_JWT_SECRET = <$(openssl rand -base64 33)>
</nowiki>}}

== Database Setup ==

=== MariaDB / MySQL ===

{{bc|1=
CREATE DATABASE `GITEA` DEFAULT CHARACTER SET `utf8mb4` COLLATE `utf8mb4_unicode_ci`;
CREATE USER `gitea`@`localhost` IDENTIFIED BY `<password>`;
GRANT ALL PRIVILEGES ON `GITEA`.* TO `gitea`@`localhost`;
FLUSH PRIVILEGES;
}}

{{hc|/etc/gitea/app.ini|2=<nowiki>
[database]
DB_TYPE = mysql
HOST = {<ip-address>:<port>|/run/mysqld/mysqld.sock}
NAME = GITEA
USER = gitea
PASSWD = <password>
CHARSET = utf8mb4
</nowiki>}}

=== PostgreSQL ===

{{bc|1=
CREATE DATABASE GITEA;
CREATE USER gitea WITH PASSWORD <password>;
GRANT ALL PRIVILEGES ON DATABASE GITEA TO gitea;
}}

{{hc|/etc/gitea/app.ini|2=<nowiki>
[database]
DB_TYPE = postgresql
HOST = {<ip-address>:<port>|/run/postgresql/}
NAME = GITEA
USER = gitea
PASSWD = <password>
</nowiki>}}

=== SQLite Setup ===

{{hc|/etc/gitea/app.ini|2=<nowiki>
[database]
DB_TYPE = sqlite
PATH = </path/to/lite.sql>
</nowiki>}}

== Redis Setup ==

Gitea is able to take advantage of Redis. It will give your server a noticeable bump in speed.

There are four sections that need changes in order to take advantage of Redis.

{{hc|/etc/gitea/app.ini|2=<nowiki>
[indexer]
ISSUE_INDEXER_QUEUE_TYPE = redis
; Choose one of the following
ISSUE_INDEXER_QUEUE_CONN_STR = "addrs=<ip-address>:<port> db=0"
ISSUE_INDEXER_QUEUE_CONN_STR = "unix=/run/redis/redis.sock db=0"

[cache]
ADAPTER = redis
; Choose one of the following
HOST = network:tcp,addr=<ip-address>:<port>,[password=<password>,]db=0,pool_size=100,idle_timeout=180
HOST = network:unix,addr=/run/redis/redis.sock,[password=<password>,]db=0,pool_size=100,idle_timeout=180

[session]
PROVIDER = redis
; Choose one of the following
PROVIDER_CONFIG = network:tcp,addr=<ip-address>:<port>,[password=<password>,]db=0,pool_size=100,idle_timeout=180
PROVIDER_CONFIG = network:unix,addr=/run/redis/redis.sock,[password=<password>,]db=0,pool_size=100,idle_timeout=180
; If you use session in https only, set to true. Default is false.
COOKIE_SECURE = true

[task]
QUEUE_TYPE = redis
; Choose one of the following
QUEUE_CONN_STR = "addrs=<ip-address>:<port> db=0"
QUEUE_CONN_STR = "unix=/run/redis/redis.sock db=0"
</nowiki>}}

Gitea - Revision history

BrainwreckedTech: /* Server Settings */ Added Nginx Reverse Proxy Configuration

BrainwreckedTech: Created Gitea page