Hostnames and app acronyms (EDOS)¶
Audience: Agent + operator
Canonical registry of production hostnames, Docker/Traefik service keys, and spoken acronyms for the EDOS ecosystem. Use this before naming a new deployable app so you do not collide with an existing slug.
Source of truth for “is it taken?”: this file plus each app’s docker-compose.yaml / docker-compose.yml in a full clone of that repository. If they disagree, fix the docs or compose in the same change set.
Domain layout¶
| Pattern | Example | Role |
|---|---|---|
{slug}.howfe.org |
edss.howfe.org |
Default for user-facing hosted web apps and HTTP APIs |
api-cache.howfe.org |
— | Shared infrastructure (not ed* — full descriptive slug) |
docs.edos.howfe.org |
— | Hosted agent/human documentation (docs-deploy/) |
app.edos.howfe.org |
— | Desktop build-service only (elite-dangerous-local-journal-reader build-service/) — not a product UI |
Local dev commonly uses http://localhost:5173 (Vite) or project-specific ports; production Traefik uses websecure + letsencrypt (see DEPLOYMENT.md).
Naming rules (new apps)¶
- Prefix: hosted Elite Dangerous products use a 4–6 character slug starting with
ed(e.g.edss,edep). - Derive letters from the product name — usually initials of meaningful words (
elite-dangerous-stellar-scan→ ed + ss). Keep it mnemonic and unique in the table below. - FQDN:
https://{slug}.howfe.orgunless you are adding ecosystem infrastructure (then follow theapi-cacheor*.edos.howfe.orgpatterns above with maintainer agreement). - Compose service key: match the slug (
edss:indocker-compose.yaml) so Traefik router names stay predictable (edss-router,edss-service). - Desktop installer filename: when wired through the build-service, prefer
{slug}.exe(e.g.edam.exefor surface map) — see apps/elite-dangerous-local-journal-reader.md. - Shared URLs (do not re-host):
- Community HTTP APIs →
https://api-cache.howfe.org?url=... - Journal popup (typical) →
https://edjr.howfe.org - “Install on desktop” /
POST /build→https://app.edos.howfe.org - After reserving a slug: add a row to this file, set Traefik
Host(\…`)in compose, document env vars in the app capsule under [apps/](./apps/), and register the origin in Tauriremote.urls` / IFM allowlists when the app uses the local journal bridge (IPC.md).
Allocated hostnames (production)¶
Verified from workspace docker-compose* files and project READMEs unless marked planned.
| Slug | HTTPS host | Acronym / name | Workspace folder | Compose service | Notes |
|---|---|---|---|---|---|
api-cache |
api-cache.howfe.org |
API cache | api-cache-server |
api-cache |
Bun API; container port 3000 |
app.edos |
app.edos.howfe.org |
Build service | elite-dangerous-local-journal-reader |
edapp |
/build, /artifacts/*; port 8787 — not a journal UI |
docs.edos |
docs.edos.howfe.org |
EDOS docs | docs-deploy |
edos-docs |
MkDocs + /raw/*.md |
edjr |
edjr.howfe.org |
EDJR (remote journal reader) | elite-dangerous-remote-journal-reader |
edjr |
IFM popup; File System Access API |
edjev |
edjev.howfe.org |
EDJEV | elite-dangerous-journal-event-viewer |
edjev |
Default Tauri webview appUrl in many defaults |
edam |
edam.howfe.org |
Surface map (legacy slug edam) | elite-dangerous-surface-map |
edam |
Quasar UI; opens EDJR popup |
edss |
edss.howfe.org |
Stellar Scan | elite-dangerous-stellar-scan |
edss |
Vite + Solid body table |
edca |
edca.howfe.org |
Credit Account | elite-dangerous-credit-account |
edca |
Credit ledger UI |
edpa |
edpa.howfe.org |
Planet analyser | elite-dangerous-planet-analyser |
edpa |
Headless HTTP API; port 3000 |
edep |
edep.howfe.org |
Expedition planner | elite-dangerous-expedition-planner |
edep |
Route progress UI |
edis |
edis.howfe.org |
Interstellar Scan | elite-dangerous-interstellar-scan |
edis |
Hosted table UI |
edsu |
edsu.howfe.org |
Systems uninhabitet | elite-dangerous-systems-uninhabitet |
edsu |
Colonisation candidate search |
Libraries and non-hosted projects¶
These folders have no *.howfe.org product host — consume them via npm or Bun imports only:
| Folder | Package / role |
|---|---|
elite-dangerous-event-types |
@howfe/elite-dangerous-event-types |
inter-frame-messenger |
@howfe/inter-frame-messenger |
stellar-forge-helper |
@howfe/stellar-forge-helper |
Scaffold repos (no hostname reserved yet)¶
Capsules exist under apps/; no Traefik host is allocated in this workspace until compose is added. Pick a new ed* slug using the rules above, then add a row to Allocated hostnames.
| Workspace folder | Suggested direction for slug letters |
|---|---|
elite-dangerous-universe-map |
e.g. edum (universe map) — verify unused before commit |
elite-dangerous-universe-places |
e.g. edup — verify unused |
elite-dangerous-orrery-map |
e.g. edom — verify unused |
elite-dangerous-living-interior |
e.g. edli — verify unused |
elite-dangerous-planet-scan |
e.g. edps — verify unused |
elite-dangerous-app-composition |
e.g. edac is taken (edca); choose a distinct slug |
Quick cross-reference (shared dependencies)¶
| Need | URL |
|---|---|
| SPANSH / EDSM / community APIs | https://api-cache.howfe.org?url=... |
| Journal events in browser (popup) | https://edjr.howfe.org |
| Desktop bridge installer API | https://app.edos.howfe.org |
| Agent documentation (raw Markdown) | https://docs.edos.howfe.org/raw/ |
Related docs¶
- REPOS.md — inventory and runtime URL call sites in code
- ARCHITECTURE.md — how hosts connect in the journal/cache flow
- DEPLOYMENT.md — Traefik compose template
- AGENTS.md — checklist when adding a new project
- apps/ — per-app capsules and env vars