Files
ipcr-forge/README.md
T

2.0 KiB

IPCR Forge

A self-hosted forge whose releases live on IPFS: work in Gitea as usual, its Actions build your images, the IPCR engine publishes them under one IPNS name (and your ENS or DNS name), and every public repository is mirrored to Radicle.

git push origin v1.0.0
docker pull ipcr.localhost:4767/ipns/metadec.eth/ipcr-hello:1.0.0   # any host running IPCR
docker pull ipcr-<domain>/ipns/metadec.eth/ipcr-hello:1.0.0          # anywhere, through the forge

This repository is the add-on; Yundera/ipcr is the engine (the registry gateway, IPFS import, IPNS naming and admin API), used here as the image ghcr.io/yundera/ipcr.

  • docs/forge.md: how it works, the trust model, findings, what was verified.
  • Apps/IPCR-Forge-AIO (in the IPCR repository, with the rest of the IPCR app store): the Yundera AppStore listing (compose, rationale, seed). It bundles Gitea, Radicle and IPCR, and pins this repository's image and the engine's. See docs/forge.md.
  • forge/: the forge service, ghcr.io/yundera/ipcr-forge (Go, standard library only): the Gitea → Radicle mirror, the forge's page and admin pages (Gitea login), the staging registry's gate and per-repository push credentials, and the install step.
  • The standalone listings the forge is built from, Gitea and Radicle, are in the same store.

Develop

cd forge && go vet ./... && go test ./...
docker build -t ghcr.io/yundera/ipcr-forge:dev forge

Releases: a vX.Y.Z tag publishes ghcr.io/yundera/ipcr-forge:X.Y.Z (.github/workflows/image.yml). Then bump the version in the listing, Apps/IPCR-Forge-AIO/docker-compose.yml in the IPCR repository (the service, forge-gate and the forge-setup step).