doc: add first readme

2026-06-29 00:21:50 +01:00
parent 0d079ee672
commit 480bdf3fe2
1 changed files with 16 additions and 0 deletions
@@ -1 +1,17 @@
 # Home Infrastructure
+
+## Setup
+
+```shell
+just fetch-plugins
+```
+
+## Bare-metal provisioning
+
+When creating a set of fresh machines, you must run the provisioning step to create the "Kolibri" automation user.
+
+The Kolibri automation user is used for all other playbooks and has permissions to execute passwordless sudo.
+
+```shell
+ansible-playbook -i ansible/inventories/bare_metal/hosts.yaml ansible/playbooks/provision.yaml -K -e ansible_user=<your_interactive_user>
+```