cabele/proxMon
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: runbook notes assets.deploy runs in release step + troubleshooting entry

Browse source
This commit is contained in:
Carsten 2026-04-22 10:19:52 +02:00
parent 50676a7cb8
commit f616d466eb
1 changed files with 6 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

7
SETUP-AND-DEPLOY.md
View file

@ -114,8 +114,12 @@ into the LXC env file later.
MIX_ENV=prod DASHBOARD_PASSWORD_HASH='placeholder' mix release --overwrite MIX_ENV=prod DASHBOARD_PASSWORD_HASH='placeholder' mix release --overwrite
``` ```
The release step also runs `mix assets.deploy` as a pre-assemble step, so
minified + digested JS/CSS are baked into the tarball automatically. You
don't need to run `assets.deploy` separately.
**Expected:** `_build/prod/rel/server/` contains `bin/server`, `bin/migrate`, **Expected:** `_build/prod/rel/server/` contains `bin/server`, `bin/migrate`,
`erts-*`, `lib/`, `releases/`. `erts-*`, `lib/`, `releases/`, and `lib/server-0.1.0/priv/static/cache_manifest.json`.
- [ ] Package the release: - [ ] Package the release:
@ -816,6 +820,7 @@ Tick each box before declaring the rollout complete.
| LXC can't bind port 4000 | Another process owns it. `ss -ltnp | grep 4000`. | | LXC can't bind port 4000 | Another process owns it. `ss -ltnp | grep 4000`. |
| `mix release` fails with DASHBOARD error | You forgot to set `DASHBOARD_PASSWORD_HASH=placeholder` at build. | | `mix release` fails with DASHBOARD error | You forgot to set `DASHBOARD_PASSWORD_HASH=placeholder` at build. |
| Agent logs `{:enoent, "pvesh"}` | Agent is running on a non-Proxmox host, or `$PATH` is empty under systemd. | | Agent logs `{:enoent, "pvesh"}` | Agent is running on a non-Proxmox host, or `$PATH` is empty under systemd. |
| Admin "Add host" redirects to `/admin/hosts?host%5Bname%5D=…` | Asset bundle didn't ship; `cache_manifest.json` missing → LiveView JS never attaches → native HTML GET submit. Rebuild the release and redeploy. |
## Appendix B — File & Port Cheat Sheet ## Appendix B — File & Port Cheat Sheet