admin
54ca055efd
gates / gates (push) Successful in 2s
The ONLY image move in this commit. Written by upgrade-test.py --write-ladder:
- bench LXC 9401 (harness v4, the bench's own BookStack fixture): FROM settled, the seeded admin
read back, migrations ran, read back after, 10-minute memory watch peak 43.7 % (anon), 0 kills,
0 restarts; the abort (old image back) starts and serves the data;
- box 9202 (controller 0.283.1, the product's guarded Update, drill catalog): done in 64.6 s, the
seeded admin read back through the app's own CLI.
The superseded step keeps its definition at steps/fdb7afbec5ea4dbc.{yml,felhom.yml} (09 §6.4 part 5).
The database half only, as before (R-460). MariaDB 12.3 does not move.
Evidence: felhom.eu/documentation/audits/pg-last-six-2026-09-30/F/ and .../box/bookstack/
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
137 lines
6.9 KiB
YAML
137 lines
6.9 KiB
YAML
# =============================================================================
|
|
# .felhom.yml - App metadata for felhom-controller
|
|
# =============================================================================
|
|
|
|
# --- Display info (shown on dashboard) ---
|
|
display_name: "BookStack"
|
|
description: "Egyszerű, könyv-szerű wiki és dokumentáció platform"
|
|
category: "productivity"
|
|
subdomain: "wiki"
|
|
slug: "bookstack"
|
|
# catalog_since: the date THIS repo last changed this app's pinned images. Any commit that
|
|
# changes an image: line must set this to the same day (see CLAUDE.md).
|
|
catalog_since: "2026-09-30"
|
|
|
|
# --- Resource hints (displayed on deploy screen) ---
|
|
resources:
|
|
mem_request: "150M"
|
|
mem_limit: "512M"
|
|
pi_compatible: true
|
|
needs_hdd: false
|
|
|
|
# --- Deploy fields (first deployment only) ---
|
|
deploy_fields:
|
|
- env_var: DOMAIN
|
|
label: "Domain"
|
|
type: domain
|
|
description: "A szerver domain neve"
|
|
locked_after_deploy: true
|
|
|
|
- env_var: SUBDOMAIN
|
|
label: "Aldomain"
|
|
type: subdomain
|
|
default: "wiki"
|
|
required: true
|
|
locked_after_deploy: true
|
|
description: "Az alkalmazás aldomainje"
|
|
|
|
- env_var: APP_KEY
|
|
label: "Alkalmazás kulcs"
|
|
type: secret
|
|
generate: "base64key:32"
|
|
locked_after_deploy: true
|
|
|
|
- env_var: DB_PASSWORD
|
|
label: "Adatbázis jelszó"
|
|
type: secret
|
|
generate: "password:24"
|
|
locked_after_deploy: true
|
|
|
|
# `09` §3 decision 45: BookStack starts with admin@admin.com / password. The box replaces that password with
|
|
# this generated one right after the install (after_install below); the app page shows it as the first password.
|
|
- env_var: ADMIN_PASSWORD
|
|
label: "Admin jelszó (admin@admin.com)"
|
|
type: password
|
|
generate: "password:24"
|
|
description: "Az első bejelentkezéshez: admin@admin.com és ez a jelszó. Utána a profilodban módosítható."
|
|
locked_after_deploy: true
|
|
|
|
# --- App info (info page content) ---
|
|
app_info:
|
|
tagline: "Egyszerű wiki platform - polcok, könyvek, fejezetek és oldalak"
|
|
default_creds: "admin@admin.com / password"
|
|
docs_url: "https://www.bookstackapp.com/docs/"
|
|
|
|
use_cases:
|
|
- 'Családi tudásbázis - receptek, kézikönyvek, szabályok'
|
|
- 'Projekt dokumentáció strukturált formában'
|
|
- 'Könyv > Fejezet > Oldal hierarchia az áttekinthetőségért'
|
|
- 'Teljes szöveges keresés és címkék'
|
|
- 'WYSIWYG és Markdown szerkesztő'
|
|
|
|
first_steps:
|
|
- 'Nyisd meg a wiki.DOMAIN címet a böngészőben'
|
|
- 'Jelentkezz be: admin@admin.com és a Beállítások oldalon látható első jelszó'
|
|
- 'Változtasd meg az admin email címét a sajátodra'
|
|
- 'Hozd létre az első polcot és könyvet'
|
|
- 'Kezdj el írni!'
|
|
|
|
|
|
# --- After a fresh install (controller >= 0.279.0, decision 45) ---
|
|
# BookStack's OWN artisan command updates the initial admin in place. Measured on 9202 2026-09-28: afterwards
|
|
# admin@admin.com / password no longer logs in, the generated password does.
|
|
after_install:
|
|
service: bookstack
|
|
env: [ADMIN_PASSWORD]
|
|
command: ["php", "/app/www/artisan", "bookstack:create-admin", "--email=admin@admin.com", "--name=Admin", "--password=${ADMIN_PASSWORD}", "--initial"]
|
|
success: "The default admin user has been updated"
|
|
|
|
# --- Controller-side health probe ---
|
|
healthcheck:
|
|
checks:
|
|
- type: http
|
|
port: 80
|
|
|
|
# --- English copy (localisation slice 5, R-560) --------------------------------------------
|
|
# The Hungarian above is UNCHANGED. A box on English reads this block field by field; a missing
|
|
# field shows the Hungarian one; a controller older than 0.257.0 ignores the block entirely.
|
|
i18n:
|
|
en:
|
|
description: 'A simple, book-shaped wiki and documentation platform'
|
|
app_info:
|
|
tagline: 'A simple wiki platform - shelves, books, chapters and pages'
|
|
default_creds: 'admin@admin.com / password'
|
|
use_cases:
|
|
- 'A family knowledge base - recipes, manuals, house rules'
|
|
- 'Project documentation with a structure you can follow'
|
|
- 'Book > Chapter > Page, so a large set stays readable'
|
|
- 'Full text search and tags'
|
|
- 'A visual editor and a Markdown editor'
|
|
first_steps:
|
|
- 'Open wiki.DOMAIN in your browser'
|
|
- 'Sign in: admin@admin.com and the first password shown on the settings page'
|
|
- 'Change the admin e-mail address to your own'
|
|
- 'Create your first shelf and book'
|
|
- 'Start writing'
|
|
deploy_fields:
|
|
- env_var: DOMAIN
|
|
label: 'Domain'
|
|
description: 'The server domain name'
|
|
- env_var: SUBDOMAIN
|
|
label: 'Subdomain'
|
|
description: 'The subdomain this app answers on'
|
|
- env_var: DB_PASSWORD
|
|
label: 'Database password'
|
|
- env_var: APP_KEY
|
|
label: 'Application key'
|
|
- env_var: ADMIN_PASSWORD
|
|
label: 'Admin password (admin@admin.com)'
|
|
description: 'For the first sign-in: admin@admin.com and this password. Change it in your profile afterwards.'
|
|
|
|
# update_ladder — the test record: one tested step per line, oldest first (JSON flow mappings,
|
|
# `09-update-architecture.md` §6.4 part 4). WRITTEN BY scripts/upgrade-test.py, never by hand;
|
|
# gated by scripts/check-test-record.py. An image: move without a proven entry here is refused.
|
|
update_ladder:
|
|
- {"from": {"bookstack": "lscr.io/linuxserver/bookstack:26.05.2", "bookstack-db": "mariadb:12.3"}, "to": {"bookstack": "lscr.io/linuxserver/bookstack:26.05.5", "bookstack-db": "mariadb:12.3"}, "digest": {"bookstack": "sha256:189c796273469115cf810e53f450e15b93184018e4728cd65fcaef8aa93584bc", "bookstack-db": "sha256:805c8e104bd563d5bfa24fadd3f31cd419ea859cb5277f32b5dbf2db714f9ed1"}, "verdict": "proven", "tested_at": "2026-09-21T18:25:39.453490+00:00", "harness_version": 1, "evidence": "felhom.eu/documentation/audits/update-night-2026-09-21/apps/bookstack/verdict.json", "memory_peak_pct": null, "marks": {"files_may_change": false, "needs_person": null, "memory_tight": false}, "backfilled": "2026-09-23", "note": "backfilled from catalog commit ac4828f; box walk only (harness v1, no memory watch); digest = what the registry served on 2026-09-23, not a measurement of the tested image"}
|
|
- {"from": {"bookstack": "lscr.io/linuxserver/bookstack:26.05.5", "bookstack-db": "mariadb:12.3"}, "to": {"bookstack": "lscr.io/linuxserver/bookstack:26.09.1", "bookstack-db": "mariadb:12.3"}, "digest": {"bookstack": "sha256:99cd1f5707c1911afad213adec5c9739763b76f843d1477142231834ecdcb6f7", "bookstack-db": "sha256:805c8e104bd563d5bfa24fadd3f31cd419ea859cb5277f32b5dbf2db714f9ed1"}, "verdict": "proven", "tested_at": "2026-09-30T11:09:02Z", "harness_version": 4, "evidence": "felhom.eu/documentation/audits/pg-last-six-2026-09-30/F/apps/bookstack/bench/evidence/MV-bookstack/verdict.json", "box_evidence": "felhom.eu/documentation/audits/pg-last-six-2026-09-30/box/bookstack/box-verdict-bookstack.json", "memory_peak_pct": 43.7, "marks": {"files_may_change": false, "needs_person": null, "memory_tight": false}, "memory_basis": "anon", "memory_cgroup_peak_pct": 58.3}
|