Recipedia

sclinux recipe & repository hub — a read-only web presentation of the canonical sclinuxdev/recipes git tree, plus built-in hosting of published binary packages.

What it does

• Recipe hub — syncs the recipes git tree (webhook or poll), parses every recipe.toml, and serves browsable package pages: metadata, dependency graph edges, reverse dependencies, and the full recipe source.
• Build status — every package's state (missing / outdated / built / ahead) is derived on request as the diff between recipe versions and the published table. Nothing is stored; the two tables are the truth.
• Multi-version recipes — a package may keep several version directories; lists and the status board show the newest, detail pages carry the ladder.
• Virtual names resolve — /package/virtual/libc doesn't 404: it lists the packages whose provides cover the name.
• Package hosting — POST /api/repo/publish/{filename} (bearer token) streams a *.pkg.tar.zst straight to disk, extracts .METADATA, regenerates an index.toml byte-compatible with sage's channel reader, and serves the lot under /repo/* with sha256 ETags. Published artifacts can be withdrawn, file listings are browsable, and build logs attach to their archive.
• recipedia CLI — login, publish (ETag-aware skip, auto-attaches a sibling <archive>.log), unpublish, status.

Running

# server (env-driven, sensible defaults)
RECIPEEDIA_STATE_DIR=/srv/recipedia RECIPEEDIA_WEBHOOK_SECRET=... recipedia-server
recipedia-server token <label>        # mint a publish token

# builder side
recipedia login https://hub.example.com --token rt_...
recipedia publish target/pkgdir/      # upload everything not yet on the server
recipedia status --state missing

Configuration is environment-only: RECIPEEDIA_LISTEN, RECIPEEDIA_DB, RECIPEEDIA_STATE_DIR, RECIPEEDIA_GIT_URL (one canonical repository; defaults to https://github.com/sclinuxdev/recipes), RECIPEEDIA_WEBHOOK_SECRET, RECIPEEDIA_POLL_SECS, RECIPEEDIA_FRONTEND_URL (public frontend origin), and RECIPEEDIA_REPO_URL (public repo domain for file links; unset keeps same-origin /repo/...).

The canonical tree layout is <category>/<name>/<arch>/<name>-<version>-<release>/recipe.toml. A sync diffs the previous and new commits and reports the architectures touched (amd64, aarch64, riscv64, armv7, any) in both the webhook response and sync log. Recipe-v2 validation mirrors Sage for the executable check phase and the structured/legacy patch checksum rules; check dependencies remain build-only metadata.

Deploying (Docker / 1Panel)

The Dockerfile is a small Ubuntu 24.04 runtime image: it downloads the matching x86_64 glibc binaries from GitHub Releases instead of compiling on the server. Build it only after that release exists:

docker build --pull --build-arg RECIPEEDIA_VERSION=0.1.6 \
  -t recipedia:0.1.6 -t recipedia:latest \
  https://github.com/sclinuxdev/recipedia.git#v0.1.6
install -d -m 0750 /srv/recipedia
RECIPEEDIA_DATA_DIR=/srv/recipedia docker compose up -d --force-recreate
docker exec recipedia recipedia-server token <label>

For 1Panel, run the docker build command in the server terminal first, then open 容器 → 编排 → 创建编排 and paste compose.yaml. Set RECIPEEDIA_DATA_DIR=/srv/recipedia in the compose environment so removing or moving the compose project cannot remove SQLite, the git mirror, packages, or logs. Create a reverse proxy from the public site to 127.0.0.1:8300; if using the split domains shown in compose.yaml, proxy the repository domain to http://127.0.0.1:8300/repo/ with the trailing slash. Configure the GitHub webhook payload URL as https://<frontend>/api/webhook/github, content type application/json, and use the same secret as RECIPEEDIA_WEBHOOK_SECRET.

To upgrade, replace 0.1.6 with the new release in the build command, retag recipedia:latest, and run docker compose up -d --force-recreate again. The mounted data directory is reused and the disposable recipe cache is rebuilt from the canonical git source.

Build

cargo build --release
cargo test && cargo clippy --all-targets

Rust + axum + SQLite; the only state is one SQLite file, a read-only git mirror, and the published package directory.

License

BSD-2-Clause — see LICENSE.