---
title: Consuming pre-releases
---

All PRs that are marked as **draft** will have binary artifacts built for it so that one can test things out before the PR is accepted and merged in.
The artifacts are not published to the production sources, as everything is built in debug mode and not considered ready
for production. We leverage GitHub packages for these builds. You can browse all the [pre-release packages on GitHub](https://github.com/orgs/cratis/packages?repo_name=Chronicle).

Whenever packages have been built, the build with add comments with links to the artifacts into the pull request:

![](./github-comments-pr.png)

To consume the packages, you'll need to configure the sources in your local repository.

## Docker

Browse all [Docker container images on GitHub](https://github.com/orgs/cratis/packages?ecosystem=container).

For Docker there is no need to configure anything locally, all you need to do is change the image you're using
from for instance `cratis/chronicle:latest-development` to the specific one @ GitHub, e.g. : `ghcr.io/cratis/chronicle:6.11.6-pr537.adedc72`.

## NuGet

Browse all [NuGet packages on GitHub](https://github.com/orgs/cratis/packages?ecosystem=nuget).

To consume packages, you'll need to configure either your global or local to your NuGet project. To start with you'll need a GitHub personal access token,
read the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) on how this works.

NuGet supports having multiple sources, if you want to configure this globally available for all projects on your computer you can simply add a source using the dotnet CLI:

```shell
dotnet nuget add source --username USERNAME --password ${{ secrets.GITHUB_TOKEN }} --store-password-in-clear-text --name cratis "https://nuget.pkg.github.com/cratis/index.json"
```

If you want to set it up locally for your repository, you can drop inn a `NuGet.Config` file into your repository configured with the username and token.

> Note: The token is your personal access token, and if it is a read only token it is safe for other users to use. But if it has write access to anything, you should
> not share this token with anyone.

```xml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <packageSources>
        <add key="ChroniclePreReleases" value="https://nuget.pkg.github.com/cratis/index.json" />
    </packageSources>


    <packageSourceCredentials>
        <ChroniclePreReleases>
            <add key="Username" value="USERNAME" />
            <add key="cleartextpassword" value="TOKEN" />
        </ChroniclePreReleases>
    </packageSourceCredentials>
</configuration>
```

Then all you need to do is use the correct version number for the package references you have.
For instance in your `.csproj` file(s):

```xml
<PackageReference Include="Cratis.Chronicle" Version="6.11.6-pr537.adedc72"/>
```

> For more details, read the [GitHub documentation](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry#authenticating-to-github-packages).