Click here to Skip to main content
15,354,006 members
Articles / Programming Languages / C#
Posted 15 Nov 2007


71 bookmarked

Multiple Instance .NET Windows Service

Rate me:
Please Sign up or sign in to vote.
4.77/5 (51 votes)
15 Nov 2007CPOL5 min read
This article describes how to implement a .NET Windows Service that can have multiple instances installed on the same machine.


It's not readily apparent how to install a Windows Service multiple times on a single machine. At first glance, it seems like it's not supported by the operating system. When attempting to install a second instance of a service using InstallUtil on the same machine, you'll likely be presented with the following message:

Screenshot - InstallUtilMultipleServiceException.gif

Fortunately, there is a way around this. If you have a need to install multiple instances of the same service, then please read on.

The Problem

When reviewing the ServiceInstaller class using Reflector, you'll see it does a Win32 call to CreateService in the ServiceInstaller.Install method. CreateService will return the ERROR_DUPLICATE_SERVICE_NAME return code whenever the method is called with a serviceName or displayName parameter that matches that of an already installed service. This is what causes the Win32Exception to be thrown in the above window and ultimately causes the second install to fail. You can view the complete documentation on the CreateService function here.

To get around this, all that needs to be done is to dynamically set the service name during installation and service startup to a known value and to make sure that value is different for each instance of the service you install.

The Solution

All that needs to be done is to make sure that the name of each service installation instance is unique. Then you need to have copies of installation directories for each service instance you'd like to have. Finally, you need to be able to set the service name dynamically during installation and startup. This will be facilitated using the app.config file.

Storing the Service Name

The cleanest and most readily available way of providing the service name is to use an app.config file for your service and create an appSettings key that can be read from to set the service name. An app.config file needs to be added to your solution if one doesn't already exist to store the unique service name in order to dynamically set the ServiceInstaller.ServiceName and the ServiceBase.ServiceName to the same service name value you added to your configuration.

Alternately, we could have provided a custom command line switch to the InstallUtil during installation like InstallUtil /i /servicename="Service Instance 1" MultipleInstanceService.exe. Then that would allow us to pull the servicename property off the Context.Parameters collection during installation. The reason I chose not to recommend this option is that it does not allow us to reliably set the ServiceBase.ServiceName to the exact value that was provided during installation. Someone installing the service could mistype the servicename they provide during install which wouldn't match the value set in configuration.

        <add key="ServiceName" value="Service Instance 1"/>

Reading the Service Name from Configuration

The app.config file needs to be accessible during the installation of the service as well as when the service starts up. This is cake while the service is running because the configuration file loaded into the configuration system will be the configuration file for your service. It is a little trickier during installation. The reason why it's more difficult during installation is the fact that InstallUtil which is used to install the service does not run in the same execution path your service does, instead it runs at <system drive>:\windows\Microsoft.NET\Framework\v2.0.50727\. So, we need to find another way to access the configuration file for our service.

The easiest and most reliable way I found to do this is to use the Assembly class in the System.Reflection namespace. Using the Location property of the Assembly, we can identify the installation path of the Windows Service and open that services configuration file as shown below.

private string GetConfigurationValue(string key)
    Assembly service = Assembly.GetAssembly(typeof(MultipleInstanceInstaller));
    Configuration config = ConfigurationManager.OpenExeConfiguration(service.Location);
    if (config.AppSettings.Settings[key] != null)
        return config.AppSettings.Settings[key].Value;
        throw new IndexOutOfRangeException
            ("Settings collection does not contain the requested key: " + key);

Now that the app.config file can be read during installation, all we need to do is create an instance of a ServiceInstaller class and set the ServiceName property to the value we have stored in configuration. Using the method in the code snippet above, this is an easy task.

ServiceInstaller installer = new ServiceInstaller();
installer.ServiceName = GetConfigurationValue("ServiceName");
return installer;

Now that we've created our ServiceInstaller class instance as described above and added it to the Installers collection of our root System.Configuration.Install.Installer class marked with the RunInstaller(true) attribute of our Windows Service project, there's only one last thing to do. We need to set the ServiceBase.ServiceName of our service class instance when the service starts up. This time we'll use the ConfigurationManager class directly to read our services configuration file in the constructor of our service instance.

public MultipleInstanceService()

    this.ServiceName = ConfigurationManager.AppSettings.Get("ServiceName");

Now all that is left to do is install this service at a few different locations on the same machine. Adding a new instance of the service becomes as simple as a copy/paste of the service installation directory and change of some configuration values.

Copy of debug to model multiple directory installations.

I just made a copy of the debug directory in order to have another service installation directory. It'd be better to use a different convention for directory names than I've done here, but this is just for illustration. Now that there are two copies of the same service on your machine all that is left to do is install them.

Multiple service instances

From a command prompt, you'll need to use InstallUtil to install both instances of your service. For instructions on how to use InstallUtil, see Installer Tool (InstallUtil.exe). Once you're done installing the service instances, you'll have something like the services console above where Service Instance 1 and Service Instance 2 are created from the same executable, only installed from different directory locations with a different service name.


Being able to use the services application model to manage your application's runtime is an invaluable asset. Using the pattern I've presented, you can now leverage multiple instances of the same service on a single machine with little effort. Hopefully you'll find this method as useful as I did.


  • 2007.11.16 - Changes based on reader comments - removed sample scenario and replaced with why you're not able to install a second instance of the service. Added alternate way of passing service name into the installer class.
  • 2007.11.15 - Original post


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Wil Peck
Software Developer (Senior)
United States United States
No Biography provided

Comments and Discussions

QuestionHow is the Copy of Debug folder created in bin? Pin
Member 118154815-May-20 2:54
MemberMember 118154815-May-20 2:54 
QuestionPerfect Solution Pin
Pradeep_Kumar_Verma17-Jan-19 21:42
MemberPradeep_Kumar_Verma17-Jan-19 21:42 
QuestionPerfect! Pin
conkien4-Dec-16 20:02
Memberconkien4-Dec-16 20:02 
GeneralJust loved it Pin
Humayun Kabir Foysol11-Feb-14 3:05
MemberHumayun Kabir Foysol11-Feb-14 3:05 
QuestionNice job Pin
William H Peak3-Jan-14 5:04
MemberWilliam H Peak3-Jan-14 5:04 
AnswerRe: Nice job Pin
Wil Peck20-Jan-14 10:21
MemberWil Peck20-Jan-14 10:21 
QuestionJust what I was looking for.. Pin
PeterA4-Nov-13 17:17
professionalPeterA4-Nov-13 17:17 
AnswerRe: Just what I was looking for.. Pin
Wil Peck5-Nov-13 2:28
MemberWil Peck5-Nov-13 2:28 
QuestionGreat article Pin
Member 1017852625-Sep-13 10:22
MemberMember 1017852625-Sep-13 10:22 
AnswerRe: Great article Pin
Wil Peck25-Sep-13 10:41
MemberWil Peck25-Sep-13 10:41 
QuestionNot Multiple Instance but Multiple diferent services Pin
MagnoSr20-Aug-13 2:00
MemberMagnoSr20-Aug-13 2:00 
GeneralMy vote of 5 Pin
Rai Pawan22-Nov-12 0:39
MemberRai Pawan22-Nov-12 0:39 
Great article wil
QuestionHow to create event log from config file? Pin
umasabari5-Jan-12 16:29
Memberumasabari5-Jan-12 16:29 
QuestionMultiple instance of windows service Pin
gopimanikandan29-Sep-11 0:55
Membergopimanikandan29-Sep-11 0:55 
AnswerRe: Multiple instance of windows service Pin
Tomskyblue26-Jan-12 4:59
MemberTomskyblue26-Jan-12 4:59 
QuestionDuplicate Service Created Pin
davjanks24-Jul-11 21:52
Memberdavjanks24-Jul-11 21:52 
AnswerRe: Duplicate Service Created Pin
Tomskyblue26-Jan-12 5:00
MemberTomskyblue26-Jan-12 5:00 
GeneralGoing to try an alternative... Pin
rkecher2-Jun-11 8:23
Memberrkecher2-Jun-11 8:23 
GeneralRe: Going to try an alternative... Pin
Wil Peck3-Jun-11 8:01
MemberWil Peck3-Jun-11 8:01 
GeneralRe: Going to try an alternative... Pin
rkecher21-Jun-11 8:33
Memberrkecher21-Jun-11 8:33 
GeneralRe: Going to try an alternative... Pin
Wil Peck21-Jun-11 9:12
MemberWil Peck21-Jun-11 9:12 
GeneralRe: Going to try an alternative... Pin
rkecher21-Jun-11 9:17
Memberrkecher21-Jun-11 9:17 
GeneralRe: Going to try an alternative... Pin
Wil Peck22-Jun-11 3:00
MemberWil Peck22-Jun-11 3:00 
GeneralRe: Going to try an alternative... [modified] Pin
Trekstuff8-Jul-11 7:19
MemberTrekstuff8-Jul-11 7:19 
GeneralGreat article Pin
Anekin24-May-11 11:52
MemberAnekin24-May-11 11:52 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.