https://github.com/carnivuth/labcraft
homelab provisioning and maintenance operations
https://github.com/carnivuth/labcraft
ansible ansible-playbook ansible-playbooks ansible-project homelab homelab-automation homelab-setup proxmox
Last synced: 4 months ago
JSON representation
homelab provisioning and maintenance operations
- Host: GitHub
- URL: https://github.com/carnivuth/labcraft
- Owner: carnivuth
- Created: 2023-10-14T19:05:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-03-01T17:27:08.000Z (4 months ago)
- Last Synced: 2026-03-01T19:43:29.629Z (4 months ago)
- Topics: ansible, ansible-playbook, ansible-playbooks, ansible-project, homelab, homelab-automation, homelab-setup, proxmox
- Language: HCL
- Homepage:
- Size: 4.6 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Labcraft
Infrastructure as code for my proxmox virtual environment instance.
```mermaid
flowchart LR
A[laptop]
B((github repo))
subgraph proxmox_host
C[vms]
D[containers]
end
A -- push commits --> B ~~~ proxmox_host -- propagates changes --> C & D
```
## Why this
The goal of this project is to manage my personal proxmox instance in a git ops way with declarative infrastructure and configurations, to achieve this goal the following tech stack is deployed:
- [terraform](https://developer.hashicorp.com/terraform) to provision qemu managed virtual machines and LXC containers
- [docker](https://www.docker.com/) to manage services for personal use
- [ansible](docs.ansible.com/ansible/latest/index.html) to automate provisioning operations
- [git](https://git-scm.com/) to version the infrastructure state
- bash scripting for utilities and workflows
## Features
- Auto provisioning of vm and containers with DNS already configured and other basic utilities
- Deployment of docker compose sets of services
## Concepts and problem modeling
Refer to the [basic concepts page](doc/concepts.md)
## Installation
Refer to the [installation page](doc/installation.md)
## Create new contariner/virtual machine
Refer to the [infrastrucure page](doc/infrastructure.md)
## Backup management
Refer to the [backup page](doc/backup.md)
## Deploy new docker services
Refer to the [new docker service deployment page](doc/docker_service.md)