Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marcorfilacarreras/homelab
My homelab setup
https://github.com/marcorfilacarreras/homelab
ansible docker homelab rpi
Last synced: about 1 month ago
JSON representation
My homelab setup
- Host: GitHub
- URL: https://github.com/marcorfilacarreras/homelab
- Owner: MarcOrfilaCarreras
- License: mit
- Created: 2022-11-25T22:46:47.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-22T19:10:13.000Z (7 months ago)
- Last Synced: 2024-05-22T20:28:40.461Z (7 months ago)
- Topics: ansible, docker, homelab, rpi
- Language: Jinja
- Homepage:
- Size: 13.4 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Homelab
 
## :information_source: Overview
Welcome to my personal homelab setup! This repository houses all the Ansible playbooks I use to configure and manage my Raspberry Pi 4.
### :books: Tech stack
Logo
Name
Ansible
Docker
GitHub
Duplicati
Transmission
Pihole
Twitch-channel-points-miner-v2
Amule
Watcharr
Vikunja
Registry
Watchtower
Goatcounter
Flame
Filebrowser
Jellyfin
### :memo: Usage
To set up your homelab using the provided Ansible playbooks, follow these steps:
1. **Clone the Repository:**
```bash
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`:
```bash
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`:
```bash
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:
```bash
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.
### :triangular_ruler: Dependencies
1. **Ansible**
- community.general.docker_container
### :bulb: Diagram
```
+------------------+
| Internet |
+--------+---------+
|
|
+--------v---------+
| Router |
+--------+---------+
|
|
+--------v---------+
| Switch |
+--------+---------+
|
|
+------------+------------+
| |
+--------v---------+ +--------v---------+
| Raspberry Pi | | Other Devices |
+--------+---------+ +--------+---------+
```
## :key: License
Distributed under the MIT License. See `LICENSE.md` file for more information.