2018-06-26 22:23:55 +00:00
---
layout: "docs"
page_title: "Windows Service"
sidebar_current: "docs-guides-windows-service"
description: |-
2018-06-29 01:18:14 +00:00
By using the _sc_ command either on Powershell or
2018-06-26 22:23:55 +00:00
the Windows command line, you can make Consul run as a service. For more details about the _sc_ command
the Windows page for [sc ](https://msdn.microsoft.com/en-us/library/windows/desktop/ms682107(v=vs.85 ).aspx)
should help you get started.
---
2019-04-16 21:14:10 +00:00
# Run Consul as a Service on Windows
By using the _sc_ command, either on Powershell or
the Windows command line, you can run Consul as a service. For more details about the _sc_ command
2018-06-26 22:23:55 +00:00
the Windows page for [sc ](https://msdn.microsoft.com/en-us/library/windows/desktop/ms682107(v=vs.85 ).aspx)
should help you get started.
2019-04-16 21:14:10 +00:00
Before installing Consul, you will need to create a permanent directory for storing the configuration files. Once that directory is created, you will set it when starting Consul with the `-config-dir` option.
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
In this guide, you will download the Consul binary, register the Consul service
with the Service Manager, and finally start Consul.
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
The steps presented here, assume that you have launched Powershell with _Adminstrator_ capabilities.
2018-06-29 01:18:14 +00:00
2019-04-16 21:14:10 +00:00
## Installing Consul as a Service
2018-06-26 22:23:55 +00:00
Download the Consul binary for your architecture.
2019-04-16 21:14:10 +00:00
Use the _sc_ command to create a service named **Consul** , that will load configuration files from the `config-dir` . Read the agent configuration
[documentation ](/docs/agent/options.html#configuration-files ) to learn more about configuration options.
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
```text
2019-06-18 07:50:07 +00:00
sc.exe create "Consul" binPath= "< path to the Consul . exe > agent -config-dir < path to configuration directory > " start= auto
2019-04-16 21:14:10 +00:00
[SC] CreateService SUCCESS
```
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
If you get an output that is similar to the one above, then your service is
registered with the Service Manager.
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
If you get an error, please check that
you have specified the proper path to the binary and check if you've entered the arguments correctly for the Consul service.
2018-06-26 22:23:55 +00:00
2018-06-29 01:18:14 +00:00
2019-04-16 21:14:10 +00:00
## Running Consul as a Service
2018-06-29 01:18:14 +00:00
2019-04-16 21:14:10 +00:00
You have two options for starting the service.
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
The first option is to use the Windows Service Manager, and look for **Consul** under the service name. Click the _start_ button to start the service.
The second option is to use the _sc_ command.
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
```text
sc.exe start "Consul"
2018-06-26 22:23:55 +00:00
2019-04-16 21:14:10 +00:00
SERVICE_NAME: Consul
TYPE : 10 WIN32_OWN_PROCESS
STATE : 4 RUNNING (STOPPABLE, NOT_PAUSABLE, ACCEPTS_SHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0
PID : 8008
FLAGS :
```
2018-06-29 01:18:14 +00:00
The service automatically starts up during/after boot, so you don't need to
2019-03-21 17:51:04 +00:00
launch Consul from the command-line again.
2019-04-16 21:14:10 +00:00
## Summary
In this guide you setup a Consul service on Windows. This process can be repeated to setup an entire cluster of agents.