2018-10-18 05:46:12 +00:00
|
|
|
=============
|
|
|
|
|
Gitea README
|
|
|
|
|
=============
|
|
|
|
|
|
2019-02-27 21:39:14 +00:00
|
|
|
This Ansible role installs Gitea - a self-hosted Git service written in Go.
|
2018-10-18 05:46:12 +00:00
|
|
|
|
|
|
|
|
Using It
|
|
|
|
|
--------
|
|
|
|
|
|
2019-03-08 07:04:29 +00:00
|
|
|
Gitea should be accessible at: http://box/gitea
|
2019-03-02 05:03:26 +00:00
|
|
|
|
2019-03-17 16:33:16 +00:00
|
|
|
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.
|
|
|
|
|
|
2019-03-02 05:03:26 +00:00
|
|
|
Configuration
|
|
|
|
|
-------------
|
|
|
|
|
|
2019-03-17 16:16:43 +00:00
|
|
|
Gitea has been configured to work with SQLite; it can also be used with MySQL or
|
2019-03-08 07:04:29 +00:00
|
|
|
PostgreSQL. If you want to use it with a different database, change the
|
2019-03-17 16:16:43 +00:00
|
|
|
``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]:
|
2019-03-02 05:03:26 +00:00
|
|
|
|
2019-03-17 16:16:43 +00:00
|
|
|
* MySQL: ``After=mysqld.service``
|
|
|
|
|
* PostgreSQL: ``After=postgresql.service``
|
2019-03-02 05:03:26 +00:00
|
|
|
|
2019-03-08 07:04:29 +00:00
|
|
|
[1] Prior to installing Gitea, instead edit: ``/opt/iiab/iiab/roles/gitea/templates/app.ini.j2``
|
2019-03-08 06:41:09 +00:00
|
|
|
|
2019-03-08 07:04:29 +00:00
|
|
|
[2] Prior to installing Gitea, instead edit: ``/opt/iiab/iiab/roles/gitea/templates/gitea.service.j2``
|
2019-03-08 06:41:09 +00:00
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Further info on configuring: `https://docs.gitea.io <https://docs.gitea.io/>`_
|
