Skip to content

feat: add Quartermaster OCI image - #370

Merged
cebarks merged 2 commits into
mainfrom
worktree-feature+quma-oci-image
Jul 30, 2026
Merged

feat: add Quartermaster OCI image#370
cebarks merged 2 commits into
mainfrom
worktree-feature+quma-oci-image

Conversation

@cebarks

@cebarks cebarks commented Jul 30, 2026

Copy link
Copy Markdown
Owner

Summary

Closes #313

  • Adds container/quma/Containerfile — two-stage build that downloads the pre-built binary from a GitHub release, verifies the SHA-256 checksum, and packages it into a minimal fedora-minimal runtime image
  • Adds .github/workflows/quma-image.yml — builds and pushes ghcr.io/cebarks/quartermaster/quma on release events and manual dispatch

Usage

podman run -d \
  -v /path/to/spt-server:/opt/spt \
  -p 9190:9190 \
  ghcr.io/cebarks/quartermaster/quma:latest

The bind-mounted SPT directory must be writable (database, config, logs, backups are written there).

Limitations

  • Container management disabled — starting/stopping the SPT server or headless clients from inside the container requires Podman socket passthrough, out of scope for v1
  • x86_64 only — matches the existing release target

Test plan

  • podman build --build-arg QUMA_VERSION=v0.3.1 succeeds, checksum verified
  • podman run --entrypoint quma quma:verify --versionquma 0.3.1
  • podman run quma:verify without SPT dir → clean error message
  • Build without QUMA_VERSION → clear error guard
  • Build with bogus version → curl 404 failure
  • OCI labels match existing image patterns
  • CI workflow structure matches headless/spt-server workflows

Implemented with the help of Claude Code

cebarks and others added 2 commits July 29, 2026 22:45
When quma itself runs in a container mounting the same SPT dir,
path-based container detection can match quma's own container instead
of the SPT server. Check for the configured container name first;
path detection stays as fallback for native installs.

Credit: https://github.com/Dildz/quma-custom (commit 2f762ae)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@cebarks
cebarks merged commit 6561562 into main Jul 30, 2026
13 checks passed
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.

Feature Request: OCI (Docker/Podman) Image

2 participants