mash-playbook/docs/services/gitea.md
2023-09-06 15:56:27 +03:00

2.2 KiB

Gitea

Gitea is a painless self-hosted Git service. You may also wish to look into Forgejo - a fork of Gitea that this playbook also supports.

Dependencies

This service requires the following other services:

Configuration

To enable this service, add the following configuration to your vars.yml file and re-run the installation process:

########################################################################
#                                                                      #
# gitea                                                                #
#                                                                      #
########################################################################

gitea_enabled: true

# Gitea uses port 22 by default.
# We recommend that you move your regular SSH server to another port,
# and stick to this default.
#
# If you wish to use another port, uncomment the variable below
# and adjust the port as you see fit.
# gitea_ssh_port: 222

gitea_hostname: mash.example.com
gitea_path_prefix: /gitea

########################################################################
#                                                                      #
# /gitea                                                               #
#                                                                      #
########################################################################

In the example configuration above, we configure the service to be hosted at https://mash.example.com/gitea.

You can remove the gitea_path_prefix variable definition, to make it default to /, so that the service is served at https://mash.example.com/.

Usage

After installation, you should be able to access your new Gitea instance at the configured URL (see above).

Going there, you'll be taken to the initial setup wizard, which will let you assign some paswords and other configuration.

You may also wish to look into Woodpecker CI, which can integrate nicely with Gitea.