Plinth.WindowsService 1.7.4

Prefix Reserved

dotnet add package Plinth.WindowsService --version 1.7.4

NuGet\Install-Package Plinth.WindowsService -Version 1.7.4

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="Plinth.WindowsService" Version="1.7.4" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Plinth.WindowsService" Version="1.7.4" />
                    

                            Directory.Packages.props

<PackageReference Include="Plinth.WindowsService" />
                    

                            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 Plinth.WindowsService --version 1.7.4

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Plinth.WindowsService, 1.7.4"

#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 Plinth.WindowsService@1.7.4

#: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=Plinth.WindowsService&version=1.7.4
                    

                            Install as a Cake Addin

#tool nuget:?package=Plinth.WindowsService&version=1.7.4
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

README

Plinth.WindowsService

Makes creating a windows service easy

1. Install as service

Include these in your csproj

     <OutputType>Exe</OutputType>
     <RuntimeIdentifier>win-x64</RuntimeIdentifier>

be sure to add the --urls {URLS} parameter to your binpath
- to run multiple ports, use semi-colon ';' between urls
  - --urls http://localhost:5050;https://something/
- note the usage of SetContentRoot() when using your own IWebHost/IHost
- windows services don't start with the current directory where your .exe is
Install > sc create {ServiceName} displayName= "{DisplayName}" binpath= "D:\full\path\app.exe --urls http://localhost:9090" start= auto > sc description {ServiceName} "Service for Plinth WebApp"
Change path or params after installing > sc config {ServiceName} binPath= "{PathAndParams}"
Delete service > sc delete {ServiceName}
Start/Stop > net start {ServiceName} > net stop {ServiceName}

2. Standard ASP.NET Core project using NLog

Program.cs [below]
Add --urls http://localhost:5050 to your Debug settings as command line arguments
- to run multiple ports, use semi-colon ';' between urls
  - --urls http://localhost:5050;https://something/

public class Program
{
	public static void Main(string[] args)
	{
		var log = StaticLogManagerSetup.BasicNLogSetup();
		log.Debug("startup!");

		WindowsServiceRunner.RunWebHost(
		    BuildWebHost,
		    args,
		    callbacks: new Dictionary<ServiceState, Action>()
		    {
		        [ServiceState.Starting] = () => log.Debug("Starting..."),
		        [ServiceState.Started] = () => log.Debug("Started"),
		        [ServiceState.Stopping] = () => log.Debug("Stopping..."),
		        [ServiceState.Stopped] = () => log.Debug("Stopped"),
		    });
	
		log.Debug("exit!");
	}

	public static IWebHost BuildWebHost(string[] args) =>
	    WebHost.CreateDefaultBuilder(args)
	        .UseStartup<Startup>()
	        .UseContentRoot(WindowsServiceRunner.FindContentRoot())   // <====  REALLY IMPORTANT!
	        .ConfigureLogging(builder => builder.AddNLog())
	        .CaptureStartupErrors(false)
	        .Build();
}

3. Console project (no web interface), without NLog

Program.cs [below]
Add --urls http://localhost:5050 to your Debug settings as command line arguments
- to run multiple ports, use semi-colon ';' between urls
  - --urls http://localhost:5050;https://something/

	static void Main(string[] args)
	{
		var log = StaticLogManagerSetup.ConfigureForConsoleLogging();

		log.Debug("startup!");

		var mycallbacks = new Dictionary<ServiceState, Action>()
		{
		    [ServiceState.Starting] = () => log.Debug("Main: Starting..."),
		    [ServiceState.Started] = () => log.Debug("Main: Started"),
		    [ServiceState.Stopping] = () => log.Debug("Main: Stopping..."),
		    [ServiceState.Stopped] = () => log.Debug("Main: Stopped"),
		};

		try
		{
		    // option 1, make your own host and hosted service
		    // WindowsServiceRunner.RunHost(BuildHost, args, callbacks: mycallbacks);

		    // option 2, make your own hosted service
		    // WindowsServiceRunner.RunHostedService(new LoggerService(), args, callbacks: mycallbacks);

		    // option 3, a cancellable user action
		    // WindowsServiceRunner.RunAction(MyAction, args, callbacks: mycallbacks);

		    // option 4, a cancellable user action (async)
		    WindowsServiceRunner.RunAsyncAction(MyAsyncAction, args, callbacks: mycallbacks);
		}
		catch (Exception e)
		{
		    log.Fatal("failed during startup", e);
		    throw;
		}
	}

	// needed for option 1
	public static IHost BuildHost(string[] args) =>
		new HostBuilder()
		    .UseContentRoot(WindowsServiceRunner.FindContentRoot())   // <====  REALLY IMPORTANT!
		    .ConfigureServices((hostContext, services) =>
		    {
		        services.AddHostedService<LoggerService>();
		    })
		    .Build();

	// needed for option 1 and option 2
	public class LoggerService : IHostedService, IDisposable
	{
		private static readonly ILogger log = StaticLogManager.GetLogger();

		public Task StartAsync(CancellationToken cancellationToken)
		{
		    log.Debug("service start()");
		    return Task.CompletedTask;
		}

		public Task StopAsync(CancellationToken cancellationToken)
		{
		    return Task.CompletedTask;
		}

		public void Dispose()
		{
		    _timer?.Dispose();
		}
	}

	// option 3
	private static void MyAction(CancellationToken token)
	{
		while (!token.IsCancellationRequested)
		{
		    log.Debug("timer");
		    Task.Delay(TimeSpan.FromSeconds(2), token).Wait(); // try not to block on non cancellable calls
		}
	}

	// option 4
	private static async Task MyAsyncAction(CancellationToken token)
	{
		while (!token.IsCancellationRequested)
		{
		    log.Debug("timer");
		    await Task.Delay(TimeSpan.FromSeconds(2), token); // try not to block on non cancellable calls
		}
	}

Product	Compatible and additional computed target framework versions.
.NET	net6.0-windows7.0 is compatible. net7.0-windows was computed. net8.0-windows was computed. net8.0-windows7.0 is compatible. net9.0-windows was computed. net9.0-windows7.0 is compatible. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net6.0-windows7.0
- Microsoft.AspNetCore.Hosting.WindowsServices (>= 6.0.36 && < 7.0.0)
- Microsoft.Extensions.Hosting (>= 9.0.7)
- Microsoft.Extensions.Hosting.WindowsServices (>= 9.0.7)
- Microsoft.SourceLink.Bitbucket.Git (>= 1.1.1)
- Plinth.Common (>= 1.7.4)
- Plinth.Logging.NLog (>= 1.7.4)
- System.Text.Json (>= 9.0.7)
net8.0-windows7.0
- Microsoft.AspNetCore.Hosting.WindowsServices (>= 8.0.18 && < 9.0.0)
- Microsoft.Extensions.Hosting (>= 9.0.7)
- Microsoft.Extensions.Hosting.WindowsServices (>= 9.0.7)
- Microsoft.SourceLink.Bitbucket.Git (>= 1.1.1)
- Plinth.Common (>= 1.7.4)
- Plinth.Logging.NLog (>= 1.7.4)
- System.Text.Json (>= 9.0.7)
net9.0-windows7.0
- Microsoft.AspNetCore.Hosting.WindowsServices (>= 9.0.7)
- Microsoft.Extensions.Hosting (>= 9.0.7)
- Microsoft.Extensions.Hosting.WindowsServices (>= 9.0.7)
- Microsoft.SourceLink.Bitbucket.Git (>= 1.1.1)
- Plinth.Common (>= 1.7.4)
- Plinth.Logging.NLog (>= 1.7.4)
- System.Text.Json (>= 9.0.7)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.7.4	196	8/6/2025
1.7.3	34	8/2/2025
1.7.2	176	3/16/2025
1.7.1	146	12/12/2024
1.7.0	119	11/12/2024
1.6.6	128	11/8/2024
1.6.5	140	8/31/2024
1.6.4	125	8/2/2024
1.6.3	157	5/15/2024
1.6.2	184	2/16/2024
1.6.1	217	1/5/2024
1.6.0	198	11/30/2023
1.5.10-b186.aca976b4	100	11/30/2023
1.5.9	147	11/29/2023
1.5.9-b174.64153841	97	11/23/2023
1.5.9-b172.dfc6e7bd	84	11/17/2023
1.5.9-b171.4e2b92e2	98	11/4/2023
1.5.8	163	10/23/2023
1.5.7	213	7/31/2023
1.5.6	201	7/13/2023
1.5.5	210	6/29/2023
1.5.4	308	3/7/2023
1.5.3	306	3/3/2023
1.5.2	381	1/11/2023
1.5.2-b92.7c961f5f	167	1/11/2023
1.5.0	408	11/9/2022
1.5.0-b88.7a7c20cd	153	11/9/2022
1.4.7	494	10/20/2022
1.4.6	496	10/17/2022
1.4.5	495	10/1/2022
1.4.4	464	8/16/2022
1.4.3	477	8/2/2022
1.4.2	497	7/19/2022
1.4.2-b80.7fdbfd04	192	7/19/2022
1.4.2-b74.acaf86f5	185	6/15/2022
1.4.1	499	6/13/2022
1.4.0	535	6/6/2022
1.3.8	545	4/12/2022
1.3.7	518	3/21/2022
1.3.6	543	3/17/2022
1.3.6-b67.ca5053f3	199	3/16/2022
1.3.6-b66.4a9683e6	199	3/16/2022
1.3.5	539	2/23/2022
1.3.4	561	1/20/2022
1.3.3	424	12/29/2021
1.3.2	549	12/11/2021
1.3.1	396	11/12/2021
1.3.0	424	11/8/2021
1.2.3	470	9/22/2021
1.2.2	467	8/20/2021
1.2.1	420	8/5/2021
1.2.0	468	8/1/2021
1.2.0-b37.a54030b9	238	6/24/2021
1.1.6	522	3/22/2021
1.1.5	466	3/9/2021
1.1.4	463	2/27/2021
1.1.3	493	2/17/2021
1.1.2	470	2/12/2021
1.1.1	472	2/1/2021
1.1.0	571	12/16/2020
1.1.0-b27.b66c309b	360	11/15/2020
1.0.12	626	10/18/2020
1.0.11	570	10/6/2020
1.0.10	487	9/30/2020
1.0.9	508	9/29/2020
1.0.8	718	9/26/2020
1.0.7	675	9/19/2020
1.0.6	580	9/3/2020
1.0.5	594	9/2/2020
1.0.4	555	9/1/2020
1.0.3	614	9/1/2020
1.0.2	601	8/29/2020
1.0.1	631	8/29/2020
1.0.0	610	8/29/2020
1.0.0-b1.c22f563d	338	8/28/2020

net9.0 support

Plinth.WindowsService 1.7.4

README

Plinth.WindowsService

net6.0-windows7.0

net8.0-windows7.0

net9.0-windows7.0

NuGet packages

GitHub repositories