Roll Your Own Git Repository Server

This is a rollyourown project to deploy a Gitea git server using Ansible, Packer and Terraform.

Project Summary

This project uses Ansible, Packer and Terraform to deploy a Gitea server, with a MariaDB backend database, HAProxy for TLS/SSL termination and Certbot for managing your Let's Encrypt certificate.

How to Use

A detailed description of how to use a rollyourown project to deploy and maintain an open source solution can be found on the rollyourown website.

In summary, to deploy a project:

1. Acquire a domain to use for your project, or re-use a domain you already own

2. Prepare a control node with the basic software to run the rollyourown automation scripts, or use an existing control node you have previously set up

3. Prepare a host server for deploying the project to, or use an existing host server you have previously set up

4. Enter the working directory (e.g. ~/ryo-projects) on the control node and clone the project repository from Codeberg or GitHub

    cd ~/ryo-projects
    git clone https://codeberg.org/rollyourown-xyz/ryo-gitea.git
   

   or

    cd ~/ryo-projects
    git clone https://github.com/rollyourown-xyz/ryo-gitea.git
   

5. Copy the project's configuration file and add settings

    cd ~/ryo-projects/ryo-gitea
    cp configuration/configuration_TEMPLATE.yml configuration/configuration_<HOST_NAME>.yml
    nano configuration/configuration_<HOST_NAME>.yml
   

6. Run the deployment script from the project directory

    cd ~/ryo-projects/ryo-gitea
    ./deploy.sh -n <HOST_NAME> -v <VERSION>
   

How to Collaborate

We would be delighted if you would like to contribute to rollyourown and there are a number of ways you can collaborate on this project:

• Raising security-related issues
• Contributing bug reports, feature requests and ideas
• Improving the project - e.g. to provide fixes or enhancements

You may also like to contribute to the wider rollyourown project by, for example:

• Contributing a new project or module
• Contributing to the rollyourown website content or design
• Maintaining a rollyourown repository

Issues for this project can be submitted on Codeberg (preferred) or GitHub:

• Issues on Codeberg: here
• Issues on GitHub: here

Security Vulnerabilities

If you have found a security vulnerability in any rollyourown service or any of the rollyourown projects, modules or other repositories, please read our security disclosure policy and report this via our security vulnerability report form.

Repository Links

For public contributions, we maintain mirror repositories of this project on Codeberg and GitHub:

• https://codeberg.org/rollyourown-xyz/ryo-gitea
• https://github.com/rollyourown-xyz/ryo-gitea

Our preferred collaboration space is Codeberg:

The primary repository for this project is hosted on our own Git repository server at:

• https://git.rollyourown.xyz/ryo-projects/ryo-gitea

Repositories on our own Git server are accessible only to members of our organisation.

Copyright, Licences and Trademarks

For information on copyright, licences and trademarks, see https://rollyourown.xyz/about/copyright_licenses_trademarks/.