Introduction to Homelab Configs

This project contains infrastructure configurations and docs for my workstations, servers and RasPi nodes. All infrastructure follows the infrastructure as code pattern.

• Documentation Website
• Github Repository
• Where to file issues
• Project Board for Issues and Pull Requests

Requirements and Features

This section outlines the basic requirements and features of the project. These requirements serve as a guideline for the development of the application and provide a clear overview of the expected functionality.

• Install all necessary software on workstations and servers. Follow Infrastructure as Code (IaC) principles. Ansible is used for this purpose.
• Every machines run services (some of them are mandatory for every machine). These services run inside Docker containers. The containers are controlled through scripts from this project.

Usage

This project contains several scripts to control the respective function set.

Scope and Context

This configuration set is intended to work specifically for our machines. You might be able to adopt some stuff from this project, but using it "as is" most likely will result in failure.

Architecture Constraints

Workstations, servers and RasPi nodes are using similar operating systems.

• Every workstation and server is using Ubuntu as operating system.
• Every RasPi node is using Raspberry Pi OS (which is based on Debian) or Ubuntu Server as operating system.

This is a constraint that is not likely to change in the future.

Contact

Feel free to contact me via sebastian@sommerfeld.io or raise an issue in this repository.