Quick Start

Introduction

NugetHosting provides secure, fast, and affordable hosting for your private NuGet packages and Docker container images.

This guide will walk you through the basic setup process to get your first package uploaded in just a few minutes.

1. Create Your Account

First, you'll need to create a free NugetHosting account:

1. Go to the registration page
2. Sign up with GitHub, Google, or your email
3. Verify your email if signing up with email

2. Create an API Token

API tokens are used to authenticate your package manager with NugetHosting:

1. Go to Dashboard → API Tokens
2. Click 'Create New Token'
3. Give your token a name (e.g., 'Development')
4. Copy the token immediately - you won't see it again!

3. Configure NuGet

Add NugetHosting as a package source in your development environment:

Option A: Using dotnet CLI

# Add NugetHosting as a package source
dotnet nuget add source https://nuget.nugethosting.com/v3/index.json \
  -n NugetHosting \
  -u api \
  -p YOUR_TOKEN

Option B: Using NuGet.config

Create or edit a NuGet.config file in your solution directory:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="NugetHosting" value="https://nuget.nugethosting.com/v3/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <NugetHosting>
      <add key="Username" value="api" />
      <add key="ClearTextPassword" value="YOUR_TOKEN" />
    </NugetHosting>
  </packageSourceCredentials>
</configuration>

4. Push Your First Package

Now you can push packages to your private feed:

# Push a package
dotnet nuget push MyPackage.1.0.0.nupkg -s NugetHosting

Next Steps

You're all set! Here are some next steps to explore: