BackWave.Hosting 1.1.1

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package BackWave.Hosting --version 1.1.1
                    


                    

                
NuGet\Install-Package BackWave.Hosting -Version 1.1.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="BackWave.Hosting" Version="1.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="BackWave.Hosting" Version="1.1.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="BackWave.Hosting" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add BackWave.Hosting --version 1.1.1
                    


                    

                
#r "nuget: BackWave.Hosting, 1.1.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package BackWave.Hosting@1.1.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=BackWave.Hosting&version=1.1.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=BackWave.Hosting&version=1.1.1
                    


                            Install as a Cake Tool

BackWave.Hosting

The Hosting Shell for BackWave. It handles DI registration, in-process Worker Groups, and fail-stop health, so this is how you actually run jobs in an ASP.NET Core or Generic Host app.

using BackWave;
using BackWave.Generated; // BackWaveJobs.Module, emitted from your [Job] methods
using BackWave.Hosting;

builder.Services.AddBackWave(backwave =>
{
    backwave
        .UseStore(new InMemoryJobStore())   // swap for a durable adapter in production
        .UseJobs(BackWaveJobs.Module);      // registers the registry + a scoped handler per [Job]

    backwave.AddWorkerGroup(new WorkerGroupOptions
    {
        Name = "default",
        Policy = new DispatchPolicy.Strict(["critical", "default"]),
        PollInterval = TimeSpan.FromMilliseconds(250),
        RetryPolicy = new RetryPolicy { MaxAttempts = 5, Backoff = _ => TimeSpan.FromSeconds(1) },
    });
});

Enqueue from anywhere via the injected BackWaveClient:

app.MapPost("/greet", async (BackWaveClient client, string name) =>
{
    var jobId = await client.EnqueueAsync(new Greet(name), dueTime: DateTimeOffset.UtcNow);
    return Results.Ok(new { jobId });
});

What it adds

  • AddBackWave(...) registers the engine, the store, and your jobs in one call.
  • Worker Groups are hosted services with per-group dispatch (Strict priority or smooth Weighted), poll interval, concurrency, and retry policy. Run several in one process, or scale them out.
  • Per-Attempt DI scope gives each execution its own scope, so your handlers inject normally.
  • Fail-stop health reports unhealthy when the engine can't make progress.

Pair with a storage adapter (BackWave.Postgres, BackWave.SqlServer, BackWave.Sqlite) for durability, and BackWave.Dashboard to watch jobs, queues, failures, and schedules.

Full documentation: https://backwave.app

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on BackWave.Hosting:

Package Downloads
BackWave.Dashboard

Read-only monitoring dashboard for BackWave: jobs, queues, failures, schedules, and observers, rendered server-side with zero static assets to host.
BackWave.Pro.Mcp

BackWave Pro: a Model Context Protocol (MCP) server over your BackWave jobs — AI agents monitor queues and jobs and (opt-in) act on them through tools mounted in your own ASP.NET Core host. Free to use under $1M annual revenue; a license is required above that.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.2.0 33 7/12/2026
1.1.1 40 7/10/2026
1.1.0 103 7/6/2026
1.0.0 102 7/6/2026

Release notes and upgrade guidance: https://backwave.app/