https://github.com/kdpuvvadi/gitea-ansible

Ansible Playbook for installing gitea on Debian based server
https://github.com/kdpuvvadi/gitea-ansible

ansible git gitea playbook-ansible

Last synced: about 2 months ago
JSON representation

Ansible Playbook for installing gitea on Debian based server

• Host: GitHub
• URL: https://github.com/kdpuvvadi/gitea-ansible
• Owner: kdpuvvadi
• License: mit
• Created: 2021-08-22T14:12:57.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-01-25T12:48:27.000Z (almost 3 years ago)
• Last Synced: 2024-07-30T18:46:31.471Z (5 months ago)
• Topics: ansible, git, gitea, playbook-ansible
• Language: Jinja
• Homepage: https://kdpuvvadi.github.io/gitea-ansible/
• Size: 104 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# Gitea Ansible playbook

Deploy Gitea, your light weight git server on Debian System with ansible playbook

## Getting Started

### Inventory

* Copy sample invetory file `inventory.ini.j2` to `inventory.ini` with `cp inventory.ini.j2 inventory.ini`

```bash

cp example.inventory.ini inventory.ini

```

* Change `ansible_host` value with host IP

* Add ssh username to `ansible_user`

### Variables

Copy sample variable file located in vars directory

`vars.yml.j2` to `vars.yml` with `cp vars.yml.j2 vars.yml`

## Ansible Installation

Install ansible with the following

### Install python3 & pip3

```bash

sudo apt install python3 python3-pip -y`

```

### Install ansible

```bash

python3 -m pip install ansible

```

## Deployment

Run the playbook with

```bash

  ansible-playbook main.yml

```

Append `-K` if ansible users needs sudo password to elevate sudo privileges

### Configuration

After succesful Deployment visit `IP:3000` and fill out the details

### Database Settings

We are using SQLite for Database.

If you are planning on running gitea with multiple teams and members it is recomended to use MySql.

* Database Type: SQLite3

* Path: Use an absolute path, `/var/lib/gitea/data/gitea.db`

* Application General Settings:

![Gitea Database Settings](./img/gitea_db.png)

* Site Title: Enter your organization name.

* Repository Root Path: Leave the default `var/lib/gitea/data/gitea-repositories`.

* Git LFS Root Path: Leave the default `/var/lib/gitea/data/lfs`.

* Run As Username: `git`

* SSH Server Domain: Enter your domain or server IP address.

* SSH Port: `22`, change it if SSH is listening on other Port

* Gitea HTTP Listen Port: `3000`

* Gitea Base URL: Use http and your domain or server IP address e.g. `http://127.0.0.1`

* Log Path: Leave the default `/var/lib/gitea/log`

![Gitea General Settings](./img/gitea_settings.png)

### Admin Account

Expand Optional settings and add details for admin account.

![Gitea Admin Settings](./img/gitea_admin.png)

To complete the installation click on install and it'll redirect to the login page.

## Post Deployment

`/etc/gitea` is temporary set with write rights for user `git`.

After installation is done, it is recommended to set rights to read-only using:

```bash

ansible-playbook post_install.yml

```

Append `-K` if ansible users needs sudo password to elevate sudo privileges

## Service management

* Start gitea Service `sudo systemctl start gitea`

* Stop gitea service `sudo systemctl stop gitea`

## License

[MIT](https://choosealicense.com/licenses/mit/)

## Authors

[@kdpuvvadi](https://www.github.com/kdpuvvadi)

## 🔗 Links

[![twitter](https://img.shields.io/badge/twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://twitter.com/kdpuvvadi)