Skip to content

Correct the Podman deployment guide after a review - #2726

Merged
jh-RLI merged 2 commits into
developfrom
docs-podman-guide-review
Oct 18, 2026
Merged

jh-RLI merged 2 commits into
developfrom
docs-podman-guide-review

Conversation

@jh-RLI

@jh-RLI jh-RLI commented Oct 15, 2026

Copy link
Copy Markdown
Contributor

A review of the six pages under docs/installation/production-podman/ against the units on develop and the running test server. Docs only, no behaviour change.

  • Ontop: both build commands tagged the image localhost/oep-ontop:latest, while the unit starts ghcr.io/openenergyplatform/oeplatform-ontop:latest. Install and Maintenance warn that exactly this mismatch fails with exit code 125; the Ontop page now uses the ghcr name like the rest of the guide.
  • Install, env table: RDF_DATABASE_HOST is in oep.env.example since Keep a filled-in oep.env out of the production image #2724 but was missing from the table. FUSEKI_ADMIN_PASSWORD was described as the Fuseki admin password; the stain/jena-fuseki image reads ADMIN_PASSWORD, so the value is ignored and Fuseki generates a random password on its first start. The page now says so. Fixing the variable itself belongs to the secrets work, not to this PR.
  • Maintenance, backups: the Fuseki volume (the OEKG) was missing from what to back up, and the commands used pgdata where Quadlet names the volume systemd-pgdata.
  • Overview: names the monitoring and links its page. Monitoring: "five questions" over a table of six.
  • Install: tested with Podman 5.4 (the note said 4.x).

mkdocs build passes locally with no warning on these pages.

🤖 Generated with Claude Code

jh-RLI and others added 2 commits October 15, 2026 17:57
- ontop: build under the ghcr name the unit starts; localhost/oep-ontop
  is the image-name mismatch that fails with exit code 125
- install: RDF_DATABASE_HOST is in the env template, and
  FUSEKI_ADMIN_PASSWORD is not read by the Fuseki image
- maintenance: volume names carry the systemd- prefix, and the Fuseki
  volume (the OEKG) belongs in the backups
- overview: name the monitoring; monitoring: six questions, not five
- install: tested with Podman 5.4

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@jh-RLI jh-RLI self-assigned this Oct 18, 2026
@jh-RLI
jh-RLI merged commit f2e7c48 into develop Oct 18, 2026
5 of 6 checks passed
@jh-RLI
jh-RLI deleted the docs-podman-guide-review branch October 18, 2026 11:02
@jh-RLI jh-RLI mentioned this pull request Oct 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant