Skip to content

docs(selfhost): add combined ORB + AMS quickstart - #6011

Closed
jsdevninja wants to merge 1 commit into
JSONbored:mainfrom
jsdevninja:feat/docs-orb-ams-combined-quickstart
Closed

docs(selfhost): add combined ORB + AMS quickstart#6011
jsdevninja wants to merge 1 commit into
JSONbored:mainfrom
jsdevninja:feat/docs-orb-ams-combined-quickstart

Conversation

@jsdevninja

Copy link
Copy Markdown
Contributor

Summary

  • Add repo-root ORB_AMS_QUICKSTART.md: single operator path for running ORB (docker-compose.yml) and AMS (fleet or laptop) on one host.
  • Document LOOPOVER_MINER_CONFIG_DIR agreement, the #5805 fleet bind-mount override, and a copy-pasteable combined compose invoke (observability + ams-observability + miner).
  • Link from README.md, packages/loopover-miner/DEPLOYMENT.md, and the miner package README. No compose/code changes.

Fleet-mode ams-observability confirmation

Verified against live YAML on current main (not historical issue prose):

  • ams-reporting-exporter mounts ${LOOPOVER_MINER_CONFIG_DIR:-~/.config/loopover-miner}:/ams-ledgers:ro.
  • docker-compose.miner.override.yml.example bind-mounts the same expression onto the fleet miner's /data/miner, replacing the named miner-data volume when that override is included.
  • Path mismatch that emptied Grafana AMS panels for fleet-only setups is therefore resolved by the documented three-file compose invoke; no new bridge code was required in this PR.
  • This contributor environment has no Docker daemon, so a live Grafana click-through was not run here. Once the miner has written ledgers and the exporter completes a cycle (~30s), AMS Attempt Log / AMS Prediction Ledger should populate the same way as laptop mode. Operators should re-check those datasources after first successful export; file a follow-up only if panels stay empty with the override present.

Also noted (out of scope, still open): #5812 PROFILES header comment omits ams-observability; #5935 fleet image tag still says gittensory-miner:latest.

Scope

Validation

Docs-only under repo root / packages/loopover-miner/**/*.md — outside Codecov src/**. Skipped full npm run test:ci (no code/schema/UI changes). Checked: git diff --check on the commit; compose wiring reviewed by file inspection.

Safety

  • No secrets or private scoring surfaces
  • No site/ / changelog edits

UI Evidence

N/A — operator markdown quickstart only (no rendered UI/site page change).

Closes #5996

Document standing up root docker-compose.yml with AMS fleet/laptop on one host, including LOOPOVER_MINER_CONFIG_DIR agreement and the fleet ams-observability bridge. Closes JSONbored#5996.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jsdevninja
jsdevninja requested a review from JSONbored as a code owner July 15, 2026 06:46
@superagent-security

Copy link
Copy Markdown
Contributor

Superagent didn't find any vulnerabilities or security issues in this PR.

@JSONbored JSONbored closed this Jul 15, 2026
@loopover-orb loopover-orb Bot added the gittensor:feature Gittensor-scored feature linked to a feature issue — scores a 0.25x multiplier. label Jul 15, 2026
@JSONbored

JSONbored commented Jul 15, 2026

Copy link
Copy Markdown
Owner

No - the issue specifically mentions to move these to the website docs (.tsx files properly organized in our website) with logical hierarchy.

reyanthony062001-ops pushed a commit to reyanthony062001-ops/gittensory that referenced this pull request Jul 15, 2026
…t-text-only enforcement

The loopover-orb review gate only checks a PR against what its linked issue
explicitly states, never implied intent. Add a dedicated reference.md section
and SKILL.md pointer so future gardening runs write hard file-type/path
constraints as standalone rules instead of narrative context (confirmed the
hard way via JSONbored#5996/JSONbored#6011). Also tighten the milestone-discipline guidance and
mark the unified AMS+ORB harness item as already scoped (JSONbored#5996, epic JSONbored#6012).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

gittensor:feature Gittensor-scored feature linked to a feature issue — scores a 0.25x multiplier.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(selfhost): document a combined ORB + AMS quickstart (running both compose files together)

2 participants