Parent: #1819
Context
The repository has a self-host release workflow that can build multi-arch GHCR images with provenance, SBOM, Sentry source maps, and GitHub Releases from selfhost-v* tags. Before cutting the first official self-host release, the release path needs an explicit checklist and clean install validation.
This issue is release-readiness work, not a request to publish immediately.
Requirements
- Define the first supported image name, tags, versioning scheme, and release trigger.
- Confirm official images include only runtime code and intended bundled tools, not source maps, local auth, private config, secrets, data volumes,
.env, or deployment overrides.
- Confirm Sentry behavior: release artifacts/source maps are uploaded for official images, but runtime reporting is disabled unless the operator sets their own
SENTRY_DSN.
- Validate clean install, upgrade from source-built deploy, rollback to prior tag, and one-service app restart behavior.
- Decide whether to publish one default image or separate
full and minimal variants for bundled AI CLIs.
- Ensure release notes clearly state what is supported, experimental, optional, and operator-owned.
Deliverables
- First-release checklist for
selfhost-v0.1.0 or the chosen initial version.
- Smoke-test matrix for fresh install, upgrade, rollback, Sentry release validation, and docs links.
- Image-size and contents audit, including
.dockerignore verification.
- Operator upgrade path from Git checkout builds to released image tags.
- GitHub Release notes template for the first self-host release.
Acceptance criteria
- A clean operator can pull a pinned GHCR image and boot the stack without building from source.
- The image contents audit proves no private configs, credentials, data, or source maps are shipped.
- Release source maps align with the baked
GITTENSORY_VERSION / Sentry release id.
- Rollback instructions are clear and tested against migration constraints.
- The release can be cut repeatably from a commit reachable from
main.
Validation
- Run release workflow dry-run or equivalent local release checks where practical.
- Build the runtime image and verify
/ready in a clean compose environment.
- Validate image metadata, SBOM/provenance settings, and Sentry release checks.
Ownership
Maintainer-only. No gittensor:* labels.
Parent: #1819
Context
The repository has a self-host release workflow that can build multi-arch GHCR images with provenance, SBOM, Sentry source maps, and GitHub Releases from
selfhost-v*tags. Before cutting the first official self-host release, the release path needs an explicit checklist and clean install validation.This issue is release-readiness work, not a request to publish immediately.
Requirements
.env, or deployment overrides.SENTRY_DSN.fullandminimalvariants for bundled AI CLIs.Deliverables
selfhost-v0.1.0or the chosen initial version..dockerignoreverification.Acceptance criteria
GITTENSORY_VERSION/ Sentry release id.main.Validation
/readyin a clean compose environment.Ownership
Maintainer-only. No
gittensor:*labels.