Feeds Stack Guide

RETIRED (2026-07-01). This stack (Verdaccio + BaGet) has been decommissioned and replaced by the Gitea package registry. See docs/runtime/stacks/gitea.mdx. The content below is retained for historical reference only.

The feeds stack provides the canonical npm and NuGet endpoints.

Source Of TruthCopy Anchor Link

• Compose: runtime/stacks/infrastructure/feeds/docker-compose.feeds.yml
• VPS env: runtime/environments/vps/infrastructure/feeds/.env
• VPS placeholder: runtime/environments/vps/infrastructure/feeds/feeds.env
• Dev template: runtime/environments/dev/infrastructure/feeds/feeds.dev.env
• Launcher: runtime/scripts/infrastructure/feeds.{sh,bat}

ServicesCopy Anchor Link

• Verdaccio at https://npm.perspective-v.com
• BaGet at https://nuget.perspective-v.com

Required VariablesCopy Anchor Link

• BAGET_HOST
• NPM_HOST
• BAGET_API_KEY
• NPM_FEED_API_KEY

DeployCopy Anchor Link

./runtime/scripts/infrastructure/feeds.sh up

Raw compose command:

docker compose --env-file runtime/environments/vps/infrastructure/feeds/.env -f runtime/stacks/infrastructure/feeds/docker-compose.feeds.yml up -d

ValidateCopy Anchor Link

./runtime/scripts/infrastructure/feeds.sh ps
curl -Ik https://npm.perspective-v.com/
curl -Ik https://nuget.perspective-v.com/v3/index.json

Client CommandsCopy Anchor Link

NuGet:

dotnet nuget remove source perspective || true
dotnet nuget add source "https://nuget.perspective-v.com/v3/index.json" --name perspective
dotnet nuget push "./bin/Release/*.nupkg" --source "https://nuget.perspective-v.com/v3/index.json" --api-key "<NUGET_FEED_TOKEN>"

npm:

npm set registry https://npm.perspective-v.com/
npm config set //npm.perspective-v.com/:_authToken "<NPM_FEED_API_KEY>"
npm publish --registry https://npm.perspective-v.com/

PolicyCopy Anchor Link

• Verdaccio: anonymous read, authenticated publish, no signup
• BaGet: public restore, API-key publish
• CI secrets must match the values used by the live feeds env file