Updated Setting up i2pd as Windows Service (markdown)

R4SAS
2022-02-23 23:13:56 +03:00
parent 4aea99c67f
commit f6a0a4b564

@@ -1,53 +1,25 @@
### Introduction
One can set up i2pd as a Windows Service. This way it will run in the
background without any annoying windows or tray icons. It can be
controlled with a standard
[*Services*](https://technet.microsoft.com/en-us/library/cc772408.aspx)
snap-in of *Microsoft Management Console (MMC)*.
One can set up i2pd as a Windows Service. This way it will run in the background without any annoying windows or tray icons. It can be controlled with a standard [*Services*](https://technet.microsoft.com/en-us/library/cc772408.aspx) snap-in of *Microsoft Management Console (MMC)*.
While it is possible to install service using corresponding
[command line option](https://github.com/PurpleI2P/i2pd/blob/openssl/docs/configuration.md),
standard tools like
[sc](https://technet.microsoft.com/en-us/library/cc990289.aspx) can be
used as well. Currently, this gives some flexibility as there in no
need to add `daemon = yes` in config, but `--daemon` can be supplied
as an argument.
While it is possible to install service using corresponding [command line option](https://github.com/PurpleI2P/i2pd/blob/openssl/docs/configuration.md), standard tools like [sc](https://technet.microsoft.com/en-us/library/cc990289.aspx) can be used as well. Currently, this gives some flexibility as there in no need to add `daemon = yes` in config, but `--daemon` can be supplied as an argument.
### Service installation
Fire up elevated Command Prompt (<kbd>Win+X</kbd>, <kbd>A</kbd> in
Windows 8) and type in the following making sure you use the correct
path where you have `i2pd.exe`.
Fire up elevated Command Prompt (<kbd>Win+X</kbd>, <kbd>A</kbd> in Windows 8) and type in the following making sure you use the correct path where you have `i2pd.exe`.
_Method one:_
```
C:\dev\i2p\appveyor\i2pd.exe --svcctl=install
```
_Method two (Mind spaces after `=`):_
_Note: Mind spaces after `=`!_
```
sc create i2pdService binPath= "C:\dev\i2p\appveyor\i2pd.exe --daemon" DisplayName= "i2pd router service" obj= "NT AUTHORITY\LocalService"
```
In both ways, the service will run under special *LocalService* user
account. Its configuration folder is likely
`C:\Windows\ServiceProfiles\LocalService\AppData\Roaming\i2pd`. You
will need elevated privileges to access this location. You may find it
handy to use [Far File Manager](http://www.farmanager.com) or alike
for such manipulations.
The service will run under special *LocalService* user account. Its configuration folder is likely `C:\Windows\ServiceProfiles\LocalService\AppData\Roaming\i2pd`.
You will need elevated privileges to access this location. You may find it handy to use [Far File Manager](http://www.farmanager.com) or alike for such manipulations.
![screenshot](Setting-up-i2pd-as-Windows-Service.png)
### Service removal
To uninstall this service use
_Method one:_
```
C:\dev\i2p\appveyor\i2pd.exe --svcctl=remove
```
_Method two:_
```
sc delete i2pdService
```