Repository navigation
Open
Description
The reader-facing site runs today as the owner's development server on the Mac Studio, reached through an ngrok tunnel (wordhoard.eu.ngrok.io). #250 asked whether that should stay so; the owner's answer on 21 October 2026 was: eventually move it, decide the host first. This issue holds the decision and the work. It absorbs #199 (Mac mini handoff), #229 and #232 (Linux gaps in dd.bootstrap.cluster).
What the dictionary needs from a host
- The site: Phoenix + Postgres 18. The corpus is 14 GB (
devils_dictionary_v2), the released bundle 3.9 GB, the absorb inputs 2.6 GB. About 25 GB covers it; 50 GB leaves room for bundles and growth. CPU and memory are modest; discovery jobs are network-bound. - The LLM part: the curation runtime (Local curation runtime: persistent Ollama service, pinned models and bounded Req inference #195, Persona panel pilot: five versioned editors, fixed quorum and ten-page evaluation #197) pins 4B and 9B models through Ollama with a single execution slot. On Apple silicon that wants roughly 6–8 GB of unified memory on top of the site. The runtime's binaries and model cache are MLX/Metal builds under
/Volumes/LLM Models/dictionary/{bin,ollama}, so a Linux host would mean rebuilding it.
What is on the network (inventoried 21 October 2026)
| Machine | Hardware | Already runs | Free disk |
|---|---|---|---|
| Mac Studio | M4 Max, 64 GB | the dictionary dev server (published host), Postgres 18 on 5434, Ollama | 1.4 TB external |
Mac mini (holdens-Mini, 192.168.1.205) |
M4, 10 cores, 16 GB, 228 GB SSD | CineGraph, RecordTemple, Pokevestment under kamal-proxy; Homebrew Postgres 18, pgbouncer, redis; Docker; Plex | 50 GB |
Argus NUC7i3BNH (argus.local) |
i3-7100U, 2 cores / 4 threads, 30 GB, Ubuntu 26.04 | Argus under kamal, Postgres 18, pgbouncer; load ≈ 5 | 1.6 TB |
| TrueNAS | NAS | storage only | — |
Recommendation
- Site and Postgres on the Mac mini. It already hosts three apps the same way (kamal-proxy, Homebrew Postgres 18, SSH), and the dictionary's migration tooling from Repeatable dictionary migration: prove external setup against the retained working baseline #211 (
dd.bundle,dd.bootstrap,dd.doctor, LaunchAgents) is macOS-native, so this is the least new work. Disk is the one constraint: 50 GB free is enough for the site but not for models too; add an external SSD or move the Plex library first. - Not the NUC. Two cores already saturated by Argus, no usable GPU, and Linux reopens Linux server deployment: dd.bootstrap.cluster must set or provision the socket directory Debian moves to /var/run/postgresql (deferred from #228) #229 and dd.bootstrap.cluster leaves lc_messages, lc_monetary, lc_numeric and lc_time at C; record and apply the source cluster's values (from #211 stage 4) #232.
- Curation stays on the Studio until measured on the mini (Local curation portability: measured Mac Studio to Mac Mini handoff #199's rule: no promised throughput before measurement). A 9B model fits beside the mini's other apps in 16 GB, but only just.
- A third machine only if the panels grow: Apple silicon so the runtime moves unchanged (a Mac mini M4 Pro with 48–64 GB and 2 TB). A Linux box with a 24 GB GPU is cheaper per token but means rebuilding the runtime.
What the code needs before any host (found in the 21 October audit)
- No release config: no
rel/, no Dockerfile, no CI workflow.config/runtime.exsalready readsDATABASE_URL,SECRET_KEY_BASE,PHX_HOST,PORT,POOL_SIZEin:prod, so a standardmix releasewithmix assets.deployis the short route. - Provider keys are read from
.envonly in:dev; on a host the twelve provider variables must be exported (names in.env.exampleandconfig/runtime.exs). - Two pins to lift:
config/prod.exssets:public_routingtofalse(Routing: everything left to close #194 — Stage 5 publication behind a feature flag, then the reviewer tool (after #224) #237 D5, because the dev server was the only published host), and the published-host behaviour (DD_PUBLISHED_HOST,ProxyGuard, the separateMIX_BUILD_ROOT) lives in the dev block only. Once the dev server is no longer the public host, most of Routing: everything left to close #194 — Stage 5 publication behind a feature flag, then the reviewer tool (after #224) #237's tunnel guards can go, as Routing scope creep: what we wanted, what was built, and what it broke (#194, #237) #250 noted. - The mailer is deliberately unconfigured in production (
DevilsDictionary.Mailer): login links will not send. Decide whether reviewers need to log in on the host at all before launch. force_sslis on in prod. Leaving ngrok removes itsX-Robots-Tag: noindex, nofollow, so the site becomes indexable; open registration through the public host (flagged on Routing: everything left to close #194 — Stage 5 publication behind a feature flag, then the reviewer tool (after #224) #237) must be decided before that.
Phases
- Decide: host (mini recommended), domain, whether reviewers log in on it, whether registration stays open.
- Prepare the mini: disk (external SSD or move Plex), a
devils_dictionarycluster or database on its Postgres 18, the twelve provider variables, a secret key base. - Build:
mix release+mix assets.deploy; lift the:public_routingpin and move the published-host settings to runtime config for:prod; decide which of Routing: everything left to close #194 — Stage 5 publication behind a feature flag, then the reviewer tool (after #224) #237's guards to keep (operator pages 404 publicly stays). - Restore:
mix dd.bundle --verifyandmix dd.bootstrap --mode initfrom the latest released bundle, thenANALYZE(a fresh restore has no planner statistics). - Cut over: domain and TLS to the mini, the Studio's tunnel and
DD_PUBLISHED_HOSTturned off, the dev server back to a plain development server. - Later, measured: curation runtime on the mini (Local curation portability: measured Mac Studio to Mac Mini handoff #199's checklist, now here), or a third machine.
Decisions only the owner can make
Host, domain name (#192), reviewer login on the public host, open registration, and whether to buy a third machine.
Metadata
Metadata
Assignees
Labels
No labels
Activity