Quick Start

Create your first repository, push a package, and configure your team - in under five minutes.

1. Create an account

Sign up at feedz.io/auth/register. No credit card required - you start on the free plan automatically.

During sign-up you will create an organisation - a container for all your repositories, members, and billing. You can use your company name or division name.

2. Create a repository

From your organisation dashboard, click Add Repository. Choose:

  • A name - used in the repository URL
  • Visibility - private (requires authentication) or public (anyone can download)

Once created, your repository URL is shown on the repository page. For NuGet it looks like:

https://f.feedz.io/{organisation}/{repository}/nuget/index.json

3. Generate a personal access token

Go to Your Account → Personal Access Tokens and click Add Token. Give it a name, set an expiry if you want, and choose Read/Write access. Copy the token immediately - it is only shown once.

For CI/CD pipelines and build servers, use a service account token instead of your personal token. That way pipelines keep working if you leave the organisation.

4. Configure your client

Add the source using your access token as the password:

dotnet nuget add source https://f.feedz.io/my-org/my-repo/nuget/index.json \
  --name feedz \
  --username feedz \
  --password <your-token> \
  --store-password-in-clear-text
npm adduser \
  --registry https://f.feedz.io/my-org/my-repo/npm/ \
  --scope my-company \
  --always-auth
choco source add \
  --name feedz \
  --source https://f.feedz.io/my-org/my-repo/nuget/index.json \
  --user feedz \
  --password <your-token>

For npm, the --scope flag tells npm to route packages in that scope to Feedz and pull everything else from the public registry. The scope must match the prefix in your package names (e.g. @my-company/my-package).

See the NuGet, npm, or Chocolatey pages for full client configuration details.

5. Push your first package

dotnet nuget push MyPackage.1.0.0.nupkg \
  --source https://f.feedz.io/my-org/my-repo/nuget/index.json \
  --api-key <your-token>
npm publish my-package-1.0.0.tgz --scope my-company
choco push MyPackage.1.0.0.nupkg \
  --source https://f.feedz.io/my-org/my-repo/nuget/index.json \
  --api-key <your-token>

The package will appear in your repository within seconds.

6. Invite your team

Go to Organisation → Members and click Invite Members. Enter their email addresses and assign them to a team. They will receive an invite link by email.

By default all members can view all repositories. To restrict access, create a custom team with specific repository permissions before inviting.