Repository navigation
Conversation
added 3 commits
October 21, 2026 16:56
Add docs/build-from-source.md as the single user-facing build entry point: tag-vs-main, feed/installer links for ready-made packages, the CI-overhaul and reproducible-builds status, pinned toolchains, the target table, cold-cache battery, package builds, and the #1036 go.sum troubleshooting. Add make package-ipk (local-build-ipk.sh) and make package-apk (build-sdk-package.sh) as the two shippable package targets. portal-build is their prerequisite; the low-level build-ipk.sh packer is deliberately not wrapped. Fix manual-build-check.sh cleanup: the Go module cache is read-only, so chmod -R u+w before rm -rf. Without this, a successful battery exited 1 in the trap. Link the manual from README, CONTRIBUTING and release-process; update the reproducible-builds cross-link.
The local SDK path built tollgate-wrt and tollgate but not the CVM module, while packaging/Makefile requires the prebuilt daemon. Build it presence-conditionally (main carries it; older tags predate it), matching packaging/local-build-ipk.sh and the feed's CVM stanza.
Acknowledge the messy build setup, note that GitHub removed CI from all\nOpenTollGate repositories, link the installer runbook for normal installs,\nand state that CI and reproducible builds are being rebuilt. Add the required\nchangelog fragment for the build-from-source manual and package targets.
Contributor
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Add a tested, user-facing build-from-source manual and make the build
targets explicit.
docs/build-from-source.md— tag-vs-main, ready-made package links(feed releases + installer), the requested build-setup status note
(apology, GitHub-stripped CI across OpenTollGate repos, installer runbook,
CI/reproducible-builds work), pinned toolchains, target table, cold-cache
gate, package builds, artifact verification, and the Build fails on main: missing go.sum entry for go-nostr/nip19 (btcutil/bech32) #1036
go.sumtroubleshooting.
make package-ipk— full.ipkviapackaging/local-build-ipk.sh.make package-apk—.apkviascripts/build-sdk-package.sh.make manual-check/make cold-battery— executable manual checks in afresh module cache.
scripts/build-sdk-package.shto stage thetollgate-cvmdaemon; theSDK recipe requires it, and without it
make package-apkfails.scripts/manual-build-check.shcleanup (chmod -R u+wbeforerm -rf;the Go module cache is read-only, so the trap could turn a green battery into
exit 1).
README.md,CONTRIBUTING.md,docs/release-process.md, anddocs/reproducible-builds.md.portal-buildis documented as the prerequisite it is, not a package build.packaging/build-ipk.shremains the low-level packer and is not wrapped.Why
Warm
GOMODCACHEhides missinggo.sumentries; cached CI stayed green whilea cold user build failed (#1036). The manual makes the tag/
maindistinctionexplicit, and the cold-cache check is the interim gate until the CI lanes are
rebuilt. The build-setup note apologizes for the current mess and points normal
users at the installer runbook instead of a source build.
#1032 (merged as
4e55543) fixes the remaining two modules; thev0.6.0tagis clean and no v0.6.1 is needed.
Testing
make go-batteryonv0.6.0(9364f2e) — PASS, 16 modules.make go-batteryonmainpost-fix(modules): complete the go-nostr nip19 go.sum for the two remaining carriers #1032 — PASS, 18 modules.make package-ipk ARCH=x86_64— PASS,packaging/tollgate-wrt_v0.6.0-rc4_x86_64.ipk(8.5 MB; main still carriesthe rc4 VERSION until the release-metadata PR merges).
make package-apk SDK_TAG=x86-64-25.12.0— PASS after the CVM fix,tollgate-wrt-0.6.0_rc4-r0.apk(12.6 MB).TG_TOOLS=... make manual-checkwith pinned Node/npm — running againsta clean clone; result will be added here.
tollgate-infrastructure-kitsyntax-checks.No tag or release is moved by this PR.
Supersedes #1041
#1041’s head ref stopped syncing after its first commit, so the CVM fix and the
feedback/changelog commit could not be added there. This PR carries the full
tree; #1041 is closed, not merged.