HomeCloudPlaybooks/README.md

HomeCloudPlaybooks

This repository contains Ansible playbooks for setting up and configuring a home cloud environment.

Requirements

• Ansible 2.9 or higher
• Python 3.6 or higher
• sshpass installed on the control node

Usage

1. Clone the repository:

   git clone https://gitea.tobjend.de/tobi/HomeCloudPlaybooks.git
   cd HomeCloudPlaybooks
   

2. Install Ansible collections:

   ansible-galaxy collection install -r playbooks/requirements.yml
   

3. Configure the inventory:

   • Copy the inventory/hosts.yml.example to inventory/hosts.yml.
   • Update the inventory/hosts.yml file with your host information.

4. Configure secrets:

   • This project uses Ansible Vault to manage secrets.
   • Create a vault_password.txt file with your vault password.
   • Run the playbooks using the --vault-password-file option:

     ansible-playbook playbooks/main.yml --vault-password-file vault_password.txt
     

Inventory Structure

The inventory is located in the inventory directory. The main inventory file is hosts.yml. The inventory is organized into groups of hosts.

Roles

The following roles are available in the playbooks/roles directory:

• gitea: Installs and configures Gitea, a self-hosted Git service.
• ... (more roles to be documented here)