iiab/roles/gitea

=============
Gitea README
=============

This Ansible role installs Gitea - a self-hosted Git service written in Go.

Using It
--------

Gitea should be accessible at: http://box/gitea

Installation and Setup
----------------------

Simply run ``sudo ./runrole gitea`` to install Gitea. After installing, Gitea 
will be live at http://box/gitea.

The first time you access the Gitea web interface, the home page will appear. 
Clicking on "Register" or "Sign In" in the upper right corner will take you to 
the setup page. The recommended settings have been configured for you, but you 
can change them if you want. For example, you may want to change the site title 
to match the name of your organization.

After finishing the setup process, you will be directed to a page where you can 
create a user account. The first account created after setting up Gitea will be 
an admin account.

Configuration
-------------

Gitea has been configured to work with SQLite; it can also be used with MySQL or
PostgreSQL. If you want to use it with a different database, change the 
``DB_TYPE`` property in ``/etc/gitea/app.ini`` [1] and add one of the following 
lines to the ``[Unit]`` section of ``/etc/systemd/system/gitea.service`` [2]:

* MySQL: ``After=mysqld.service``
* PostgreSQL: ``After=postgresql.service``

[1] Prior to installing Gitea, instead edit: ``/opt/iiab/iiab/roles/gitea/templates/app.ini.j2``

[2] Prior to installing Gitea, instead edit: ``/opt/iiab/iiab/roles/gitea/templates/gitea.service.j2``

Documentation
-------------

Further info on configuring: `https://docs.gitea.io <https://docs.gitea.io/>`_