Skip to content

MarcOrfilaCarreras/homelab

Repository files navigation

Homelab

License GitHub last commit

ℹ️ Overview

Welcome to my personal homelab setup! This repository houses all the Ansible playbooks I use to configure and manage my Raspberry Pi 4.

📚 Tech stack

Logo Name
Ansible
Docker
GitHub
Duplicati
Transmission
Pihole
Twitch-channel-points-miner-v2
Amule
Watcharr
Vikunja
Registry
Watchtower
Goatcounter
Flame
Filebrowser
Jellyfin

📝 Usage

To set up your homelab using the provided Ansible playbooks, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/MarcOrfilaCarreras/homelab.git
    cd homelab
  2. Copy Variables File:

    • Duplicate the vars.yml.example file and rename it to vars.yml:
      cp vars.yml.example vars.yml
    • Open the vars.yml file in your preferred text editor and fill in the necessary variables with your specific configuration details. This file contains essential settings for your homelab setup.
  3. Copy Servers File:

    • Duplicate the servers.example file and rename it to servers:
      cp servers.example servers
    • Open the servers file in your preferred text editor and fill in the necessary variables with your specific configuration details. This file contains essential settings for your homelab setup.
  4. Run Ansible Playbook:

    • Execute the Ansible playbook to deploy and configure your homelab:
      ansible-playbook -i servers deploy.yml
    • The playbook will automate the provisioning and configuration of your homelab based on the variables you provided in the vars.yml file.

📐 Dependencies

  1. Ansible
    • community.general.docker_container

💡 Diagram

                            +------------------+
                            |     Internet     |
                            +--------+---------+
                                     |
                                     |
                            +--------v---------+
                            |      Router      |
                            +--------+---------+
                                     |
                                     |
                            +--------v---------+
                            |      Switch      |
                            +--------+---------+
                                     |
                                     |
                        +------------+------------+
                        |                         |
               +--------v---------+      +--------v---------+
               |   Raspberry Pi   |      |   Other Devices  |
               +--------+---------+      +--------+---------+

🔑 License

Distributed under the MIT License. See LICENSE.md file for more information.