0.2.3: include formend.inc so POSTs carry the XigmaNAS authtoken (fixes 401); README notes

This commit is contained in:
Claw committed 2026-11-17 20:10:52 +01:00
1 parent 18859ac3cc
commit dea7668fd8
7 files changed
+20 -7

No files matched your search

+14 -1
View File
@@ -22,11 +22,24 @@ state/ log/ backup/ runtime data, never touched by updates
```sh
mkdir -p -m 0750 /mnt/Daten/extensions/vmmngr && cd /mnt/Daten/extensions/vmmngr
fetch https://git.familie-berner.de/.../vmm-init && chmod +x vmm-init && ./vmm-init -o
fetch https://git.familie-berner.de/Xigmanas/vmmngr/raw/branch/main/vmm-init
chmod +x vmm-init && ./vmm-init -o
```
Then open **Extensions → VM Manager**.
## XigmaNAS specifics worth knowing
- **Every POST needs an authtoken.** `auth.inc` rejects POSTs without a valid
`authtoken` field with `401` *and destroys the session*. Always
`include 'formend.inc';` inside a form - it emits the hidden field.
- **`/etc/rc.conf` is generated from `/conf/config.xml`** at boot; `sysrc`
changes do not survive. Persist via rc params in the config.
- **PHP runs as root** (lighttpd spawns php-cgi), so the code must be strict
about input handling - all `vm` calls go through `vmm-ctl`.
- **Embedded platforms** keep `/` in RAM: binaries belong in `vendor/`, only
symlinks go into the system, repaired by `vmm-init -p` at boot.
## Design rules
- **Never overlay.** An existing system installation always wins; the bundle only