aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorJan Tuomi <jan@jantuomi.fi>2025-12-27 10:09:48 +0200
committerJan Tuomi <jan@jantuomi.fi>2025-12-27 10:09:48 +0200
commitb75c3a0f7b8d99600f4ae322bb28a4d7d68d7942 (patch)
tree66b81a05798922259bef6298b29fbf579f08a852 /README.md
parentbd0deda7816914f35f343fa394ff2fefac1a7207 (diff)
Fix README
Diffstat (limited to 'README.md')
-rw-r--r--README.md8
1 files changed, 6 insertions, 2 deletions
diff --git a/README.md b/README.md
index 774b67f..389e728 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
This repository describes my home server setup with Ansible. The server machine is an Intel N150 based mini-PC with two wired network interfaces and four M.2 NVMe slots. The NVMe slots are fitted with 1TB drives.
+The playbook is unlikely to work without modification for you.
+
## Manual installer setup
1. Download a recent FreeBSD release. Tested with https://download.freebsd.org/releases/amd64/amd64/ISO-IMAGES/14.3/FreeBSD-14.3-RELEASE-amd64-memstick.img.
@@ -14,7 +16,7 @@ This repository describes my home server setup with Ansible. The server machine
- root encrypted (GELI), GPT (BIOS+UEFI)
- 8GB of non-mirrored, encrypted swap (times four for a total of 32GB)
- install base, kernel, src, ports, handbook
- - set up IPv4 (DHCP) and v6 (SLAAC) with DNS 192.168.0.1 and 8.8.8.8
+ - set up static IPv4 (192.168.0.10/16) with DNS 192.168.0.1
- services: sshd, ntpd, ntpd sync on start, powerd
3. After install, open a shell in the chroot env and temporarily allow in `/etc/ssh/sshd_config`:
@@ -30,7 +32,9 @@ PermitRootLogin yes
## Running the playbook
-Use an [.envrc file](https://direnv.net/) to provide secrets through the shell environment. Required variables are listed in `playbook.yml`.
+Use a `secrets.yml` file to provide secrets for Ansible to use. Required variables are not really listed anywhere at the moment, you'll have to dig through the code. Ansible will report errors if any required variables are missing.
+
+Run the playbook or only some tagged sub-playbooks:
```shell
ansible-playbook -i inventory playbook.yml -t [tag1] [tag2] ...